Claude Platform Docs
Справочник по 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.
    • Claude Enterprise Analytics API:
      • Отчёты об использованииДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. и затратахДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. по каждому пользователю больше не содержат actor.email. Используйте вместо этого actor.email_address.
      • Ответ сводок активностиДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. больше не содержит summaries. Используйте вместо этого data.
  • 2023-06-01
    • Новый формат для «server-sent events» (событий, отправляемых сервером), или SSE, при потоковой передаче (streaming):
    • Удалены устаревшие значения exception и truncated в ответах.
  • 2023-01-01: Первоначальный выпуск.

Эта страница была полезной?