---
title: Обзор API
url: https://platform.claude.com/docs/ru/api/overview
description: Изучите доступные конечные точки Claude API, заголовки аутентификации, клиентские SDK, пагинацию, ограничения скорости и варианты доступа через облачные платформы.
---
Claude API — это RESTful API по адресу `https://api.anthropic.com`, который предоставляет программный доступ к моделям Claude и управляемым агентам Claude (Claude Managed Agents).
**Впервые работаете с Claude?** Для прямого доступа к моделям начните с [Начало работы](https://platform.claude.com/docs/ru/get-started) и [Работа с сообщениями](https://platform.claude.com/docs/ru/build-with-claude/working-with-messages). Для инфраструктуры управляемых агентов см. [Быстрый старт Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/quickstart).
## Предварительные требования
Чтобы использовать Claude API, вам понадобится:
* [Учётная запись Claude Console](https://platform.claude.com)
* [Ключ API](https://platform.claude.com/settings/keys) из Console или настроенное правило [Workload Identity Federation](https://platform.claude.com/docs/ru/manage-claude/workload-identity-federation)
Пошаговые инструкции по настройке см. в разделе [Начало работы](https://platform.claude.com/docs/ru/get-started).
## Доступные API
Claude API включает следующие API:
* **[Messages API](https://platform.claude.com/docs/ru/api/messages/create)**: Отправка сообщений Claude для диалоговых взаимодействий (`POST /v1/messages`)
* **[Message Batches API](https://platform.claude.com/docs/ru/api/messages/batches/create)**: Асинхронная обработка больших объёмов запросов Messages со снижением стоимости на 50% (`POST /v1/messages/batches`)
* **[Token Counting API](https://platform.claude.com/docs/ru/api/messages/count_tokens)**: Подсчёт токенов в сообщении перед отправкой для управления затратами и ограничениями скорости (`POST /v1/messages/count_tokens`)
* **[Models API](https://platform.claude.com/docs/ru/api/models/list)**: Список доступных моделей Claude и их подробностей (`GET /v1/models`)
* **[Files API](https://platform.claude.com/docs/ru/api/files/upload)**: Загрузка и управление файлами для использования в нескольких вызовах API (`POST /v1/files`, `GET /v1/files`)
* **[Skills API](https://platform.claude.com/docs/ru/api/skills/create)**: Создание и управление пользовательскими навыками агентов (`POST /v1/skills`, `GET /v1/skills`)
Следующие API находятся в бета-версии:
* **[Agents API](https://platform.claude.com/docs/ru/managed-agents/agent-setup)**: Определение переиспользуемых, версионируемых конфигураций агентов для Claude Managed Agents (`POST /v1/agents`, `GET /v1/agents`)
* **[Sessions API](https://platform.claude.com/docs/ru/managed-agents/sessions)**: Запуск сессий агентов с сохранением состояния в управляемых облачных песочницах (`POST /v1/sessions`, `GET /v1/sessions/{id}/events/stream`)
* **[Environments API](https://platform.claude.com/docs/ru/managed-agents/environments)**: Настройка шаблонов песочниц для сессий агентов (`POST /v1/environments`, `GET /v1/environments`)
Полный справочник API со всеми конечными точками, параметрами и схемами ответов см. на страницах справочника API, перечисленных в навигации. Для доступа к бета-функциям см. [Beta headers](https://platform.claude.com/docs/ru/api/beta-headers).
## Аутентификация
Подробности о каждом методе аутентификации и о том, когда его использовать, см. в разделе [Аутентификация](https://platform.claude.com/docs/ru/manage-claude/authentication). Запросы к Claude API включают следующие заголовки:
| Заголовок | Значение | Обязательный |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Authorization` | `Bearer `, где `` — ваш ключ API или краткосрочный токен доступа, полученный из `POST /v1/oauth/token` через [Workload Identity Federation](https://platform.claude.com/docs/ru/manage-claude/workload-identity-federation) | Да, если не задан `x-api-key` |
| `x-api-key` | Ваш ключ API из Console. Устаревшая альтернатива `Authorization`, по-прежнему поддерживается | Нет |
| `anthropic-workspace-id` | ID [рабочего пространства](https://platform.claude.com/docs/ru/manage-claude/workspaces), в котором выполняется запрос (например, `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`). См. [Выбор рабочего пространства](https://platform.claude.com/docs/ru/manage-claude/authentication#select-a-workspace). | Обязателен для ключа API с несколькими рабочими пространствами. Необязателен для других ключей API. Ключ, созданный для одного рабочего пространства, выполняется в этом рабочем пространстве, если заголовок не указан. Не используется с токенами Workload Identity Federation, которые выбирают рабочее пространство при обмене токенов. |
| `anthropic-version` | Версия API (например, `2023-06-01`) | Да |
| `content-type` | `application/json` | Да |
Если вы используете [клиентские SDK](https://platform.claude.com/docs/ru/api/overview#client-sdks), SDK автоматически отправляет заголовки аутентификации, версии и content-type; вы сами передаёте `anthropic-workspace-id`, когда это требуется вашему ключу. Подробности о версионировании API см. в разделе [Версии API](https://platform.claude.com/docs/ru/api/versioning).
При доступе к Claude через [облачную платформу](https://platform.claude.com/docs/ru/api/overview#claude-api-vs-cloud-platforms) аутентификация интегрирована с системой IAM облачного провайдера. См. документацию для конкретной платформы о поддерживаемых типах учётных данных, необходимых заголовках и вариантах аутентификации.
### Получение ключей API
API доступен через веб-[Console](https://platform.claude.com/). В Console вы можете использовать [playground](https://platform.claude.com/playground) (`platform.claude.com/playground`), чтобы опробовать API в браузере, а затем создать ключи API на странице [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`). Чтобы узнать, как это сделать, см. [Получите ваш ключ API Claude](https://platform.claude.com/docs/ru/get-api-key). При создании ключа вы выбираете его тип (см. [Типы ключей](https://platform.claude.com/docs/ru/manage-claude/authentication#key-types)) и [срок действия](https://platform.claude.com/docs/ru/manage-claude/authentication#key-expiration). Используйте [рабочие пространства](https://platform.claude.com/settings/workspaces) в Console, чтобы разделять среды и [контролировать расходы](https://platform.claude.com/docs/ru/api/rate-limits) по сценариям использования.
## Клиентские SDK
Anthropic предоставляет официальные SDK, которые упрощают интеграцию с API, обрабатывая аутентификацию, форматирование запросов, обработку ошибок и многое другое.
**Преимущества:**
* Автоматическое управление заголовками (аутентификация, `anthropic-version`, `content-type`)
* Типобезопасная обработка запросов и ответов
* Встроенная логика повторных попыток и обработка ошибок
* Поддержка потоковой передачи
* Тайм-ауты запросов и управление соединениями
Список клиентских SDK см. в разделе [Клиентские SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview).
## Claude API против облачных платформ
Claude доступен через прямой Claude API и через облачные платформы. Выбирайте на основе вашей инфраструктуры, доступности функций, требований соответствия и предпочтений по ценообразованию.
### Claude API
* **Прямой доступ** к новейшим моделям и функциям
* **Биллинг и поддержка Anthropic**
* **Лучше всего для:** Новых интеграций, полного доступа к функциям, прямых отношений с Anthropic
### API облачных платформ
Доступ к Claude через AWS, Google Cloud или Microsoft Azure:
* **Интегрировано** с биллингом и IAM облачного провайдера
* **Доступность функций зависит от платформы:** Платформы, управляемые Anthropic, включают [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws) и [Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry); платформы, управляемые партнёрами, включают Amazon Bedrock и Google Cloud. См. страницу каждой платформы для информации о доступности функций и сроках.
* **Лучше всего для:** Существующих облачных обязательств, конкретных требований соответствия, консолидированного облачного биллинга
| Платформа | Провайдер | Документация |
| ---------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Agent Platform | Google Cloud | [Claude на Google Cloud](https://platform.claude.com/docs/ru/build-with-claude/claude-on-vertex-ai) |
| Amazon Bedrock | AWS | [Claude в Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock) |
| Claude Platform on AWS | AWS (управляется Anthropic) | [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws) |
| Microsoft Foundry | Microsoft Azure (управляется Anthropic) | [Claude в Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry) |
Claude Managed Agents доступен через прямой Claude API и [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws). Для информации о доступности функций на разных платформах см. [Обзор функций](https://platform.claude.com/docs/ru/build-with-claude/overview).
## Формат запроса и ответа
### Ограничения размера запроса
| Конечная точка | Максимальный размер запроса |
| --------------------------------------------------------------------------------------------- | --------------------------- |
| Messages, Token Counting | 32 МБ |
| [Message Batches API](https://platform.claude.com/docs/ru/build-with-claude/batch-processing) | 256 МБ |
| [Files API](https://platform.claude.com/docs/ru/build-with-claude/files) | 500 МБ |
| Sessions, Agents, Environments | 32 МБ |
Если вы превысите эти ограничения, вы получите ошибку 413 `request_too_large`.
Платформы, управляемые партнёрами, имеют собственные ограничения размера запроса: Bedrock ограничивает запросы до 20 МБ, а Google Cloud ограничивает запросы до 30 МБ. Claude Platform on AWS использует те же ограничения, что и прямой Claude API. Обратитесь к документации вашей платформы для получения актуальных значений.
### Заголовки ответа
Claude API включает следующие заголовки в свои ответы:
| Заголовок | Описание |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `request-id` | Глобально уникальный идентификатор запроса, например `req_018EeWyXxfu5pfWkrYcMdjWG`. Включайте его при обращении в поддержку по поводу конкретного запроса. См. [Request ID](https://platform.claude.com/docs/ru/api/errors#request-id). |
| `anthropic-organization-id` | ID организации, которой принадлежит ключ API или токен доступа, использованный в запросе. |
| `anthropic-workspace-id` | ID с префиксом `wrkspc_` [рабочего пространства](https://platform.claude.com/docs/ru/manage-claude/workspaces), к которому разрешился ключ API или токен доступа, например `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`, в том числе когда это рабочее пространство по умолчанию вашей организации. Отсутствует, когда учётные данные не разрешаются в рабочее пространство (например, в запросах Admin API) или запрос завершается неудачей до завершения аутентификации. См. [Определение рабочего пространства за ответом API](https://platform.claude.com/docs/ru/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). |
Заголовки ограничения скорости см. в разделе [Заголовки ответа](https://platform.claude.com/docs/ru/api/rate-limits#response-headers) в Ограничениях скорости. Примеры чтения заголовка ответа по имени с каждым SDK см. в разделе [Определение рабочего пространства за ответом API](https://platform.claude.com/docs/ru/manage-claude/workspaces#identify-the-workspace-behind-an-api-response).
Claude Platform on AWS добавляет ID запроса AWS (`x-amzn-requestid`) наряду со стандартным заголовком `request-id`. См. [Request IDs](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#request-ids) для шаблона обработки двойного ID.
## Пагинация
Конечные точки списков возвращают результаты постранично. Большинство новых конечных точек списков используют схему курсоров `page` и `next_page`, описанную в этом разделе. Некоторые используют другую схему; см. примечание в конце этого раздела. Используйте параметр запроса `limit` для управления размером страницы и параметр запроса `page` для получения соседней страницы. Каждый ответ включает массив `data` наряду с полями курсоров для навигации между страницами.
| Имя | Расположение | Описание |
| ----------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit` | Параметр запроса | Максимальное количество элементов для возврата на страницу. |
| `page` | Параметр запроса | Непрозрачный курсор из предыдущего ответа. Передайте сюда значение `next_page` или `prev_page`, чтобы получить соседнюю страницу. |
| `order` | Параметр запроса | Направление сортировки результатов (`asc` или `desc`) на конечных точках списков, поддерживающих сортировку. Курсор `page` действителен только с тем `order`, с которым он был создан. |
| `next_page` | Поле ответа | Курсор для следующей страницы или `null`, если больше нет результатов. |
| `prev_page` | Поле ответа | Курсор для предыдущей страницы на конечных точках, поддерживающих обратную пагинацию (в настоящее время `GET /v1/sessions`), или `null`, если вы находитесь на первой странице. Другие конечные точки списков опускают это поле. |
Чтобы вернуться на страницу назад, передайте `prev_page` в качестве параметра `page`. `prev_page` равен `null`, когда вы находитесь на первой странице. Не все конечные точки списков поддерживают `prev_page`. Только `GET /v1/sessions` возвращает `prev_page`; на конечных точках списков, которые не поддерживают обратную пагинацию, это поле отсутствует в ответе, а не равно `null`. Пошаговое руководство по запросу см. в разделе [Список сессий](https://platform.claude.com/docs/ru/managed-agents/session-operations#listing-sessions).
SDK предоставляет итератор с автоматической пагинацией, который следует по `next_page` за вас. Например, `for session in client.beta.sessions.list()` (typescript: `for await (const session of client.beta.sessions.list())`; go: `client.Beta.Sessions.ListAutoPaging()`; java: `client.beta().sessions().list().autoPager()`; csharp: `(await client.Beta.Sessions.List()).Paginate()`; php: `$client->beta->sessions->list()->pagingEachItem()`; ruby: `client.beta.sessions.list.auto_paging_each`) перебирает все сессии. Автоматическая пагинация в SDK работает только вперёд; чтобы вернуться на страницу назад, прочитайте `prev_page` из ответа и самостоятельно передайте его обратно в качестве параметра `page`. Подробнее см. в разделе [клиентские SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview).
Некоторые конечные точки списков используют другую схему курсоров. [Message Batches API](https://platform.claude.com/docs/ru/build-with-claude/batch-processing), [Models API](https://platform.claude.com/docs/ru/api/models/list) и несколько конечных точек [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api) принимают параметры запроса `after_id` и `before_id` вместо `page`. Их ответы возвращают `has_more`, `first_id` и `last_id` вместо `next_page`. См. справочную страницу для каждой конечной точки для её точных полей пагинации.
## Ограничения скорости и доступность
### Ограничения скорости
API применяет ограничения скорости и ограничения расходов для предотвращения злоупотреблений и управления ёмкостью. Ограничения организованы в уровни использования; ваша организация автоматически помещается на уровень и может со временем перейти на более высокий уровень. Каждый уровень имеет:
* **Ограничения расходов**: Максимальная месячная стоимость использования API
* **Ограничения скорости**: Максимальное количество запросов в минуту (RPM) и токенов в минуту (TPM)
Вы можете просмотреть свои ограничения скорости на странице [Rate limits](https://platform.claude.com/usage/limits), а ограничения расходов — на странице [Billing](https://platform.claude.com/settings/billing) в Console. Для более высоких ограничений скорости или более высокого ежемесячного лимита расходов используйте **Request tier increase** на странице Rate limits.
Подробную информацию об ограничениях, уровнях и алгоритме token bucket, используемом для ограничения скорости, см. в разделе [Ограничения скорости](https://platform.claude.com/docs/ru/api/rate-limits).
### Доступность
Claude API доступен во [многих странах и регионах](https://platform.claude.com/docs/ru/api/supported-regions) по всему миру. Проверьте страницу поддерживаемых регионов, чтобы подтвердить доступность в вашем местоположении.
## Следующие шаги
Полная спецификация API для прямых взаимодействий с моделями
Конечные точки Agents, Sessions и Environments
Python, TypeScript, C#, Go, Java, PHP и Ruby
Уровни использования, запрос более высоких ограничений и алгоритм token bucket