Чат и сообщения

Основной текстовый эндпоинт. Принимает массив сообщений и возвращает ответ модели в OpenAI-совместимом формате, поддерживает потоковую выдачу.

POST/v1/chat/completions

Параметры запроса

ПараметрТипОбязательныйОписание
modelстрокаДаID модели из каталога, например deepseek-chat.
messagesмассивДаСообщения диалога: role (system/user/assistant) и content.
streambooleanНетЕсли true, ответ отдаётся потоком SSE по токену.
temperaturenumberНетКреативность: 0–2, по умолчанию зависит от модели.
top_pnumberНетНуклеусная выборка, альтернатива temperature.
max_tokensnumberНетВерхний предел длины ответа.

Запрос 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, полный список эндпоинтов — на обзоре.