---
title: Версии API
url: https://platform.claude.com/docs/ru/api/versioning
description: "При выполнении запросов к API вы должны отправлять заголовок запроса `anthropic-version`. Например, `anthropic-version: 2026-10-21`. Если вы используете [клиентский SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview), он устанавливает этот заголовок за вас."
---

Для любой конкретной версии API Anthropic сохраняет:

* Существующие входные параметры
* Существующие выходные параметры

Однако Anthropic может делать следующее:

* Добавлять дополнительные необязательные входные параметры
* Добавлять дополнительные значения в выходные данные
* Изменять условия для определённых типов ошибок
* Добавлять новые варианты к перечислимым выходным значениям (например, типы событий потоковой передачи)

Как правило, если вы используете API так, как описано в этом справочнике, Anthropic не нарушит работу вашего кода.

## История версий

Anthropic рекомендует по возможности использовать последнюю версию API.

* `2026-10-21`

  * В руководстве [Миграция на версию API 2026-10-21](https://platform.claude.com/docs/ru/api/migration-2026-10-21) показано, как выполнить обновление.

  * Доступна в Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ru/build-with-claude/claude-models-on-google-cloud/google-managed) и [Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry). В Amazon Bedrock она доступна для моделей Claude 4.7 и более поздних. Для более ранних моделей Claude в Bedrock [сохраните версию API, которую вы используете сейчас](https://platform.claude.com/docs/ru/api/migration-2026-10-21#availability).

  * Messages API:

    * Запрос, в котором блок `document` размещён непосредственно в сообщении `assistant`, возвращает ошибку 400.
    * Отправка блока `text` с непустым массивом `citations` в сообщении `user`, напрямую или внутри блока `search_result`, возвращает ошибку 400.
    * Параметры запроса `temperature`, `top_p` и `top_k` удалены. Запрос, в котором передаётся любой из них, возвращает ошибку 400 на любой модели.

  * Admin API:

    * [Группы RBAC](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/list) больше не возвращают `roles`. Используйте вместо этого `role_ids`.
    * [Участники групп RBAC](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/members/list), а также ответ на удаление участника, больше не возвращают `group_id`. Используйте вместо этого `rbac_group_id`.
    * [Роли RBAC](https://platform.claude.com/docs/ru/api/beta/organization/rbac_roles/list) больше не возвращают `name`. Используйте вместо этого `display_name`.
    * Записи «rate limit» (ограничения скорости) для [организации](https://platform.claude.com/docs/ru/api/organization/rate_limits/list) и [рабочего пространства](https://platform.claude.com/docs/ru/api/organization/workspaces/rate_limits/list), а также ответ на [установку ограничений скорости рабочего пространства](https://platform.claude.com/docs/ru/api/organization/workspaces/rate_limits/update) больше не возвращают `group_type`. Используйте вместо этого `group.type`.
    * [Ключи API](https://platform.claude.com/docs/ru/api/organization/api_keys/list) больше не возвращают `workspace_id`. Используйте вместо этого `scope.workspace_id`. Он содержит идентификатор рабочего пространства ключа, включая рабочее пространство по умолчанию. У ключа для всех рабочих пространств нет `scope.workspace_id`.

  * Claude Enterprise Analytics API:

    * Отчёты об [использовании](https://platform.claude.com/docs/ru/api/beta/organization/analytics/user_usage_report/list) и [затратах](https://platform.claude.com/docs/ru/api/beta/organization/analytics/user_cost_report/list) по каждому пользователю больше не содержат `actor.email`. Используйте вместо этого `actor.email_address`.
    * Ответ [сводок активности](https://platform.claude.com/docs/ru/api/beta/organization/analytics/summaries/list) больше не содержит `summaries`. Используйте вместо этого `data`.

* `2023-06-01`

  * Новый формат для «server-sent events» (событий, отправляемых сервером), или SSE, при [потоковой передаче](https://platform.claude.com/docs/ru/build-with-claude/streaming) (streaming):

    * Завершения являются инкрементальными. Например, `" Hello"`, `" my"`, `" name"`, `" is"`, `" Claude." `вместо `" Hello"`, `" Hello my"`, `" Hello my name"`, `" Hello my name is"`, `" Hello my name is Claude."`.
    * Все события являются [именованными событиями](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#named%5Fevents), а не [событиями только с данными](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#data-only%5Fmessages).
    * Удалено ненужное событие `data: [DONE]`.

  * Удалены устаревшие значения `exception` и `truncated` в ответах.

* `2023-01-01`: Первоначальный выпуск.
