POST /v1/messages
API-интерфейс сообщений, совместимый с Anthropic, с псевдонимами, потоковой передачей, инструментами, видением, кэшированием и мышлением.
POST /v1/messages
Аутентификация
x-api-key: mg_live_...
anthropic-version: 2023-06-01
content-type: application/json
Аутентификация носителя также принимается.
Запрос
curl https://api.model-gate.com/v1/messages \
-H "x-api-key: mg_live_..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4.6",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Write a short release note."}
]
}'
Ответ
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-4.6",
"content": [{"type": "text", "text": "This release improves documentation and model routing."}],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 11,
"output_tokens": 9,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}
Потоковое вещание
Добавлять "stream": true. Model Gate пересылает события SSE, совместимые с Anthropic, и записывает окончательное использование токена для расчетов.
Псевдонимы и учет
Если указан псевдоним, он заменяется канонической моделью перед постановкой запроса в очередь или отправкой вверх по течению. Цены, стоимость использования, история запросов и ограничения модели используют каноническую модель.
| Статус | Значение | Действие |
|---|---|---|
400 | Неверный запрос | Проверьте тело запроса и идентификатор модели. |
401 | Неверный или замороженный ключ | Проверьте или поменяйте ключ API. |
429 | Превышен лимит скорости или параллелизма | Уважать Retry-After и повторите попытку с отсрочкой. |
5xx | Временная ошибка восходящего потока или шлюза | Повторите идемпотентные запросы с экспоненциальной задержкой. |