Эндпоинт
POST https://api.routify.ru/v1/chat/completions
Запрос
Обязательные параметры
| Параметр | Тип | Описание |
|---|
model | string | ID модели, например gpt-4.1 |
messages | array | Массив сообщений диалога |
Необязательные параметры
| Параметр | Тип | Описание |
|---|
stream | boolean | Стриминг ответа через SSE (по умолчанию false) |
max_tokens | integer | Максимальное количество токенов в ответе |
temperature | number | Случайность ответа (0–2) |
top_p | number | Nucleus sampling |
stop | string | string[] | Стоп-последовательности |
Формат сообщений
{
"role": "user",
"content": "Привет!"
}
role: system, user, assistant, developer, tool.
Примеры
curl https://api.routify.ru/v1/chat/completions \
-H "Authorization: Bearer $ROUTIFY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4.1",
"messages": [
{"role": "system", "content": "Ты — полезный ассистент."},
{"role": "user", "content": "Объясни, что такое API"}
]
}'
Ответ (не-стриминг)
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1700000000,
"model": "gpt-4.1",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "API (Application Programming Interface) — это..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 120,
"total_tokens": 145
}
}
Стриминг
При stream: true ответ передаётся через SSE. Каждый чанк имеет вид:
data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","choices":[{"delta":{"content":"привет"},"index":0}]}
data: [DONE]
Поддерживаемые параметры — строгое подмножество OpenAI API. Параметры tools, response_format, logprobs и мультимодальный контент возвращают 400.