Использование API
Versions
При выполнении запросов к API необходимо отправлять заголовок запроса anthropic-version
. Например, anthropic-version: 2023-06-01
. Если вы используете наши клиентские библиотеки, это делается автоматически.
Для любой заданной версии API мы будем сохранять:
- Существующие входные параметры
- Существующие выходные параметры
Однако мы можем сделать следующее:
- Добавить дополнительные необязательные входные данные
- Добавить дополнительные значения в выходные данные
- Изменить условия для определенных типов ошибок
- Добавить новые варианты для значений выходных данных, подобных перечислениям (например, типы событий потоковой передачи)
В целом, если вы используете API в соответствии с документацией в этом справочнике, мы не нарушим ваше использование.
История версий
Мы всегда рекомендуем использовать последнюю версию API, когда это возможно. Предыдущие версии считаются устаревшими и могут быть недоступны для новых пользователей.
2023-06-01
- Новый формат для потоковых событий, отправляемых сервером (SSE):
- Завершения являются инкрементными. Например,
" Привет"
," меня"
," зовут"
," Клод"
,"."
вместо" Привет"
," Привет меня"
," Привет меня зовут"
," Привет меня зовут Клод"
," Привет меня зовут Клод."
. - Все события являются именованными событиями, а не событиями, содержащими только данные.
- Удалено ненужное событие
data: [DONE]
.
- Завершения являются инкрементными. Например,
- Удалены устаревшие значения
exception
иtruncated
в ответах.
- Новый формат для потоковых событий, отправляемых сервером (SSE):
2023-01-01
: Первоначальный выпуск.