POST /v1/messages
Антропно-съвместим API за съобщения с псевдоними, стрийминг, инструменти, визия, кеширане и мислене.
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 препраща съвместими с Anthropic SSE събития и записва крайното използване на токени за сетълмент.
Псевдоними и счетоводство
Ако е предоставен псевдоним, той се заменя с каноничния модел, преди заявката да бъде поставена на опашка или изпратена нагоре. Ценообразуването, разходите за използване, историята на заявките и ограниченията на модела използват каноничния модел.
| Статус | Значение | Действие |
|---|---|---|
400 | Невалидна заявка | Проверете тялото на заявката и ID на модела. |
401 | Невалиден или замразен ключ | Проверете или завъртете API ключа. |
429 | Лимитът за скорост или паралелност е надвишен | уважение Retry-After и опитайте отново с backoff. |
5xx | Временна грешка нагоре или на шлюза | Опитайте отново идемпотентни заявки с експоненциално забавяне. |