​
Доступ к API

API доступен через нашу веб-Консоль. Вы можете использовать Workbench для тестирования API в браузере, а затем генерировать API-ключи в Настройках аккаунта. Используйте рабочие пространства для сегментации ваших API-ключей и контроля расходов по случаям использования.

​
Аутентификация

Все запросы к Claude API должны включать заголовок x-api-key с вашим API-ключом. Если вы используете клиентские SDK, вы установите API при создании клиента, и затем SDK будет отправлять заголовок от вашего имени с каждым запросом. Если интегрируете напрямую с API, вам нужно будет отправлять этот заголовок самостоятельно.

​
Типы контента

Claude API всегда принимает JSON в телах запросов и возвращает JSON в телах ответов. Вам нужно будет отправлять заголовок content-type: application/json в запросах. Если вы используете клиентские SDK, это будет обрабатываться автоматически.

​
Ограничения размера запроса

API имеет максимальный размер запроса 32 МБ для стандартных конечных точек, включая Messages API и Token Counting API. Если вы превысите этот лимит, вы получите ошибку 413 request_too_large от Cloudflare. Конкретные конечные точки имеют разные ограничения:
  • Стандартные конечные точки (Messages, Token Counting): 32 МБ
  • Batch API: 256 МБ
  • Files API: 500 МБ

​
Заголовки ответа

Claude API включает следующие заголовки в каждый ответ:
  • request-id: Глобально уникальный идентификатор для запроса.
  • anthropic-organization-id: ID организации, связанный с API-ключом, используемым в запросе.

​
Примеры

Shell
curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'