Чат и сообщения
Основной текстовый эндпоинт. Принимает массив сообщений и возвращает ответ модели в OpenAI-совместимом формате, поддерживает потоковую выдачу.
POST/v1/chat/completions
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
model | строка | Да | ID модели из каталога, например deepseek-chat. |
messages | массив | Да | Сообщения диалога: role (system/user/assistant) и content. |
stream | boolean | Нет | Если true, ответ отдаётся потоком SSE по токену. |
temperature | number | Нет | Креативность: 0–2, по умолчанию зависит от модели. |
top_p | number | Нет | Нуклеусная выборка, альтернатива temperature. |
max_tokens | number | Нет | Верхний предел длины ответа. |
Запрос cURL
cURL
curl -X POST https://kiree.net/v1/chat/completions \
-H "Authorization: Bearer sk-your-kiree-key" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "system", "content": "Ты помощник kiree.net."},
{"role": "user", "content": "Напиши короткое приветствие."}
],
"stream": true
}'Потоковый ответ (Python)
Python
from openai import OpenAI
client = OpenAI(api_key="sk-your-kiree-key", base_url="https://kiree.net/v1")
stream = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Расскажи о себе в двух строках."}],
stream=True
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)Потоковая выдача (SSE)
При stream: true шлюз отдаёт ответ как Server-Sent Events: каждая порция приходит отдельным чанком с дельтой в choices[0].delta.content. Финальный чанк сигнализирует о завершении. Подробности формата потока — в спецификации OpenAI Chat Completions.
Помимо чат-формата шлюз поддерживает
/v1/completions (legacy), /v1/responses (Responses API) и /v1/messages (Anthropic-формат). Разбор формата Messages — в разделе Формат Messages, полный список эндпоинтов — на обзоре.