Справочник API
Anthropic Messages
Anthropic-совместимый формат сообщений
POST
/v1/messagesМаршрут для клиентов, которые используют Anthropic-совместимый формат сообщений.
Используйте его, если ваше приложение или библиотека уже работает с этим форматом и вам не хочется переписывать слой интеграции под chat/completions.
Правила
- Авторизация такая же:
Authorization: Bearer gw_live_.... - Модель указывается публичным именем из Gateway.
- Доступность параметров зависит от выбранной модели.
Если вы начинаете новый проект и у вас нет привязки к Anthropic-формату, чаще проще использовать POST /v1/chat/completions.
Пример запроса
curl {{PUBLIC_API_BASE_URL}}/messages \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"model": "provider/model-name",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "Сделай краткое резюме текста."}
]
}'Параметры тела запроса
| Поле | Обязательность | Описание |
|---|---|---|
model | Да | Публичное имя модели. |
messages | Да | Сообщения в Anthropic-совместимом формате. |
messages[].role | Да | Обычно user или assistant. |
messages[].content | Да | Текст или структурированный контент. |
max_tokens | Да | Максимум выходных токенов. |
system | Нет | Системная инструкция. |
temperature | Нет | Свобода генерации. |
stream | Нет | Потоковый ответ, если поддерживается. |
Поля ответа
| Поле | Обязательность | Описание |
|---|---|---|
id | Да | Идентификатор ответа. |
type | Да | Тип ответа. |
role | Да | Роль автора ответа. |
content | Да | Массив блоков ответа. |
model | Да | Модель ответа. |
stop_reason | Нет | Причина остановки. |
usage | Нет | Использование токенов. |
Пример ответа
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "provider/model-name",
"content": [
{
"type": "text",
"text": "Краткое резюме готово."
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 18,
"output_tokens": 8
}
}