Справочник по APIПоддержка и настройка
Версии API
При выполнении запросов к API вы должны отправлять заголовок запроса anthropic-version. Например, anthropic-version: 2026-10-21. Если вы используете клиентский SDK(открывается в новой вкладке), он устанавливает этот заголовок за вас.
Для любой конкретной версии API Anthropic сохраняет:
- Существующие входные параметры
- Существующие выходные параметры
Однако Anthropic может делать следующее:
- Добавлять дополнительные необязательные входные параметры
- Добавлять дополнительные значения в выходные данные
- Изменять условия для определённых типов ошибок
- Добавлять новые варианты к перечислимым выходным значениям (например, типы событий потоковой передачи)
Как правило, если вы используете API так, как описано в этом справочнике, Anthropic не нарушит работу вашего кода.
История версий
Anthropic рекомендует по возможности использовать последнюю версию API.
2026-10-21- В руководстве Миграция на версию API 2026-10-21 показано, как выполнить обновление.
- Доступна в Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) и Microsoft Foundry. В Amazon Bedrock она доступна для моделей Claude 4.7 и более поздних. Для более ранних моделей Claude в Bedrock сохраните версию API, которую вы используете сейчас.
- Messages API:
- Запрос, в котором блок
documentразмещён непосредственно в сообщенииassistant, возвращает ошибку 400. - Отправка блока
textс непустым массивомcitationsв сообщенииuser, напрямую или внутри блокаsearch_result, возвращает ошибку 400. - Параметры запроса
temperature,top_pиtop_kудалены. Запрос, в котором передаётся любой из них, возвращает ошибку 400 на любой модели.
- Запрос, в котором блок
- Admin API:
- Группы RBACДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. больше не возвращают
roles. Используйте вместо этогоrole_ids. - Участники групп RBACДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., а также ответ на удаление участника, больше не возвращают
group_id. Используйте вместо этогоrbac_group_id. - Роли RBACДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. больше не возвращают
name. Используйте вместо этогоdisplay_name. - Записи «rate limit» (ограничения скорости) для организацииДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. и рабочего пространстваДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., а также ответ на установку ограничений скорости рабочего пространстваДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. больше не возвращают
group_type. Используйте вместо этогоgroup.type. - Ключи APIДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. больше не возвращают
workspace_id. Используйте вместо этогоscope.workspace_id. Он содержит идентификатор рабочего пространства ключа, включая рабочее пространство по умолчанию. У ключа для всех рабочих пространств нетscope.workspace_id.
- Группы RBACДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. больше не возвращают
- Claude Enterprise Analytics API:
- Отчёты об использованииДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. и затратахДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. по каждому пользователю больше не содержат
actor.email. Используйте вместо этогоactor.email_address. - Ответ сводок активностиДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. больше не содержит
summaries. Используйте вместо этогоdata.
- Отчёты об использованииДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. и затратахДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. по каждому пользователю больше не содержат
2023-06-01- Новый формат для «server-sent events» (событий, отправляемых сервером), или SSE, при потоковой передаче (streaming):
- Завершения являются инкрементальными. Например,
" Hello"," my"," name"," is"," Claude."вместо" Hello"," Hello my"," Hello my name"," Hello my name is"," Hello my name is Claude.". - Все события являются именованными событиями, а не событиями только с данными.
- Удалено ненужное событие
data: [DONE].
- Завершения являются инкрементальными. Например,
- Удалены устаревшие значения
exceptionиtruncatedв ответах.
- Новый формат для «server-sent events» (событий, отправляемых сервером), или SSE, при потоковой передаче (streaming):
2023-01-01: Первоначальный выпуск.
Эта страница была полезной?