Справочник API

Messages (формат Anthropic)

POST/v1/messages

Нативный формат Anthropic с тем же bearer-ключом. Claude Code и официальные SDK anthropic работают после замены одного только базового URL — без адаптера и преобразования формата.

#Параметры запроса

  • modelstringобязательно

    ID модели Claude со страницы моделей, например claude-opus-5-5.

  • max_tokensintegerобязательно

    Обязателен в формате Anthropic — жёсткий лимит вывода.

  • messagesarrayобязательно

    Реплики в стиле Anthropic: {role: user|assistant, content}.

  • systemstringнеобязательно

    Системный промпт — здесь это поле верхнего уровня, а не роль сообщения.

  • streambooleanнеобязательно

    Передаёт нативные SSE-события Anthropic (message_start, content_block_delta, …).

  • temperaturenumberнеобязательно

    От 0 до 1 по шкале Anthropic.

  • toolsarrayнеобязательно

    Определения инструментов Anthropic; блоки tool_use возвращаются в content.

Заголовок anthropic-version

Передавайте anthropic-version: 2023-06-01, как ожидает официальный API. Здесь работает Authorization: Bearer; для стандартных SDK Anthropic также принимается x-api-key.

#Связанные ошибки

  • 400 invalid_request_errorНекорректное тело или параметр, который эта модель не поддерживает.
  • 401Bearer-токен недействителен или отсутствует. На этом пути error.code нет — ориентируйтесь на статус.
  • 402 insufficient_user_quotaБаланса кошелька не хватает на предварительно резервируемую сумму.
  • 429Ограничение частоты для ключа. Тело пустое; дождитесь Retry-After. Если же в ответе 429 есть insufficient_user_quota, это дневной лимит расходов.
  • 503 model_not_foundНеизвестная модель, или сейчас её не обслуживает ни один исправный канал.

Полная таблица кодов ошибок →

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

curl https://www.aisplice.store/v1/messages \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#Ответ

response.json
{
  "id": "msg_…",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [{"type": "text", "text": "Hello!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 10, "output_tokens": 5}
}

Проблема не решена?

Пришлите нам ID запроса или текст ошибки, и мы разберёмся.