Anthropic Messages API

Эндпоинт /v1/messages реализует формат Anthropic Messages API. Позволяет отправлять запросы к Claude и другим моделям, поддерживающим этот формат, используя те же структуры данных, что и в оригинальном Anthropic API.

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

Заголовок с API-ключом принимается в двух формах — достаточно одной из них:

Authorization: Bearer sk_ваш_api_ключ

x-api-key: sk_ваш_api_ключ

Все запросы требуют API-ключ. Получить ключ можно в личном кабинете.

Создание сообщения

POST /v1/messages

Создаёт сообщение в формате Anthropic Messages API. Поддерживает текст, изображения, PDF, инструменты (tools) и extended thinking.

Тело запроса

Параметр messages

Каждое сообщение должно содержать role и content:

• role: user или assistant
• content: строка или массив content-блоков

Типы content-блоков:

Параметр thinking

{
  "type": "enabled",
  "budget_tokens": 16000
}

• budget_tokens — бюджет токенов для этапа размышлений
• display — отображение мыслей: summarized, omitted (опционально)

Параметр provider

Настройки маршрутизации запроса к конкретным провайдерам.

Суффиксы модели

К имени модели можно добавить суффикс для быстрой настройки маршрутизации:

Пример: anthropic/claude-sonnet-4:nitro

Параметр cache_control

Автоматическое промпт-кэширование. Устанавливается на уровне запроса:

{
  "cache_control": {
    "type": "ephemeral"
  }
}

Также поддерживается на уровне отдельных content-блоков:

{
  "type": "text",
  "text": "Большой блок текста...",
  "cache_control": {
    "type": "ephemeral"
  }
}

TTL для кэша: 5m (5 минут) или 1h (1 час).

Параметр context_management

Управление контекстом (сжатие при превышении лимита токенов):

{
  "edits": [
    {
      "type": "clear_tool_uses_20250919",
      "trigger": { "type": "input_tokens", "value": 100000 },
      "keep": { "type": "tool_uses", "value": 5 },
      "clear_at_least": { "type": "input_tokens", "value": 50000 },
      "clear_tool_inputs": false,
      "exclude_tools": ["web_search"]
    }
  ]
}

Параметр output_config

Управление выходными данными:

{
  "effort": "medium",
  "format": { /* schema structured output */ },
  "task_budget": { "type": "tokens", "total": 400000 }
}

• effort: low, medium, high, xhigh, max
• format: схема структурированного вывода
• task_budget: бюджет для агентного шага (рекомендательный, не жёсткое ограничение)

Параметр fallbacks

Модели для fallback, если основная модель недоступна или отказывает:

{
  "fallbacks": [
    { "model": "claude-opus-4.8" }
  ]
}

Максимум 3 модели. Не сочетается с models.

Заголовки атрибуции

Опциональные заголовки для идентификации вашего приложения в статистике OpenRouter:

Параметр stop_server_tools_when

Условия остановки цикла server-tool агента (логика ИЛИ):

{
  "stop_server_tools_when": [
    { "type": "step_count_is", "step_count": 5 },
    { "type": "max_cost", "max_cost_in_dollars": 0.5 }
  ]
}

Пример запроса

Простой запрос:

curl https://api.ru-openrouter.ru/v1/messages \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Привет! Как дела?"
      }
    ]
  }'

С изображением:

curl https://api.ru-openrouter.ru/v1/messages \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Что изображено на этом фото?"
          },
          {
            "type": "image",
            "source": {
              "type": "base64",
              "media_type": "image/jpeg",
              "data": "/9j/4AAQSkZJRg..."
            }
          }
        ]
      }
    ]
  }'

С инструментами (tools):

curl https://api.ru-openrouter.ru/v1/messages \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Какая погода в Москве?"
      }
    ],
    "tools": [
      {
        "name": "get_weather",
        "description": "Получить погоду в городе",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "Город"
            }
          },
          "required": ["location"]
        }
      }
    ]
  }'

С extended thinking:

curl https://api.ru-openrouter.ru/v1/messages \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "max_tokens": 32000,
    "thinking": {
      "type": "enabled",
      "budget_tokens": 16000
    },
    "messages": [
      {
        "role": "user",
        "content": "Реши сложную задачу..."
      }
    ]
  }'

С потоковым режимом (streaming):

curl https://api.ru-openrouter.ru/v1/messages \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "stream": true,
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Напиши короткое стихотворение"
      }
    ]
  }'

Ответ

200 OK

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Всё отлично! Чем могу помочь?",
      "citations": null
    }
  ],
  "model": "anthropic/claude-sonnet-4",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "stop_details": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 18,
    "cache_creation_input_tokens": null,
    "cache_read_input_tokens": null,
    "total_cost": 0.1234,
    "service_tier": "standard",
    "inference_geo": null
  }
}

Поля ответа

Поля usage

Типы content-блоков в ответе

Content-блок text с цитированием

{
  "type": "text",
  "text": "Согласно документации, процессор работает на частоте 3.2 ГГц.",
  "citations": [
    {
      "type": "char_location",
      "cited_text": "процессор работает на частоте 3.2 ГГц",
      "document_index": 0,
      "document_title": null,
      "file_id": null,
      "start_char_index": 0,
      "end_char_index": 10
    }
  ]
}

Ошибки

402 Insufficient Balance:

{
  "error": {
    "message": "Недостаточно средств на балансе. Требуется: 5.00 ₽, Доступно: 1.00 ₽",
    "code": "insufficient_balance"
  }
}

400 Invalid Request:

{
  "error": {
    "message": "Missing required parameter: max_tokens",
    "code": "missing_max_tokens"
  }
}

429 Rate Limit:

{
  "error": {
    "message": "Too many requests. Please try again in 30 seconds.",
    "code": "rate_limit_exceeded",
    "retry_after": 30
  }
}

Коды ошибок