Основной метод. Принимает историю диалога, возвращает следующее сообщение. Схема совпадает с OpenAI до имён полей.
POST /api/v1/chat/completions
{
"model": "anthropic/claude-sonnet-5",
"messages": [
{"role": "system", "content": "Отвечай коротко, на русском."},
{"role": "user", "content": "Что такое токен?"}
],
"max_tokens": 512,
"temperature": 0.7
}| Роль | Что это |
|---|---|
| system | Инструкция на весь диалог. Одна, в начале. Считается как входные токены на каждый запрос — длинный system дорожает с каждым сообщением. |
| user | Реплика пользователя. |
| assistant | Прошлый ответ модели. Возвращается в истории, чтобы модель видела свой контекст. |
| tool | Результат вызова инструмента. См. раздел «Вызов инструментов». |
| Параметр | По умолчанию | Что делает |
|---|---|---|
| max_tokens | предел модели | Потолок ответа. Ограничивает счёт: выходные токены дороже входных в 3–5 раз. |
| temperature | 1.0 | 0 — детерминированный вывод, 2 — максимальный разброс. Для извлечения данных ставьте 0. |
| top_p | 1.0 | Отсечение по вероятностной массе. Крутить вместе с temperature не нужно — что-то одно. |
| stop | — | До четырёх строк, на которых генерация обрывается. |
| seed | — | Попытка воспроизводимости. Гарантии нет ни у одного провайдера. |
| response_format | — | Структурированный вывод, см. ниже. |
| provider | — | Ограничение маршрута конкретной площадкой. |
Когда ответ нужно разобрать программой, просить об этом словами не стоит: модель однажды добавит вежливое предисловие, и разбор сломается. Схема надёжнее.
{
"model": "openai/gpt-5-mini",
"messages": [{"role": "user", "content": "Разбери адрес: Москва, Тверская 1"}],
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "address",
"strict": true,
"schema": {
"type": "object",
"properties": {
"city": {"type": "string"},
"street": {"type": "string"},
"house": {"type": "string"}
},
"required": ["city", "street", "house"],
"additionalProperties": false
}
}
}
}json_schema, запрос вернёт 400, а не тихо проигнорирует поле. Поддержка видна в карточке модели.Модели с бейджем «изображения» принимают картинку в том же массиве сообщений. Ссылка или data:-URL — оба варианта работают. Список таких моделей — в каталоге по фильтру модальности.
{
"role": "user",
"content": [
{"type": "text", "text": "Что на схеме?"},
{"type": "image_url", "image_url": {"url": "https://example.ru/scheme.png"}}
]
}{
"id": "if-01J8...",
"model": "anthropic/claude-sonnet-5",
"provider": "anthropic",
"choices": [{"message": {"role": "assistant", "content": "…"},
"finish_reason": "stop"}],
"usage": {"prompt_tokens": 412, "completion_tokens": 128, "total_tokens": 540}
}Поле provider — наше дополнение к схеме: оно говорит, какая площадка фактически обслужила запрос. finish_reason со значением length означает, что ответ упёрся в max_tokens и оборван.