Обзор

​

Доступ к API

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

​

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

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

​

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

Anthropic 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 МБ

​

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

Anthropic API включает следующие заголовки в каждый ответ:

• request-id: Глобально уникальный идентификатор для запроса.

• anthropic-organization-id: ID организации, связанный с API-ключом, используемым в запросе.

​

Примеры

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-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

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-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

pip install anthropic

import anthropic

client = anthropic.Anthropic(
    # по умолчанию os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)
print(message.content)

npm install @anthropic-ai/sdk

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  apiKey: 'my_api_key', // по умолчанию process.env["ANTHROPIC_API_KEY"]
});

const msg = await anthropic.messages.create({
  model: "claude-opus-4-20250514",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Claude" }],
});
console.log(msg);