POST

/v1/chat/completions

Справочник API

OpenAI-совместимый эндпоинт для чат-запросов. Работает со всеми текстовыми моделями: Claude, GPT и GLM.

Запрос

JSON

bash

{
  "model": "claude-sonnet-5",
  "messages": [
    {"role": "system", "content": "Ты полезный ассистент"},
    {"role": "user", "content": "Расскажи про квантовую физику"}
  ],
  "max_tokens": 1024,
  "stream": false
}

Параметры

Параметр

Тип

Обязательный

Описание

model

string

Да

ID модели (см. список моделей)

messages

array

Да

Массив сообщений

max_tokens

integer

Нет

Макс. количество токенов в ответе. Для GLM Zukko поднимает его минимум до 256 (до 4096 с рассуждением)

temperature

float

Нет

Температура генерации (0-2). При 0 включается кэш Zukko (надёжнее — заголовок X-Zukko-Cache: true). Новые модели Claude могут отклонять нестандартные значения — для них не передавайте

stream

boolean

Нет

Потоковая передача ответа

top_p

float

Нет

Nucleus sampling

reasoning_effort

string

Нет

Для GLM: high включает рассуждение. Для остальных моделей передаётся провайдеру как есть

Ответ

JSON

bash

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "claude-sonnet-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Квантовая физика — это раздел..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

Потоковый режим (stream: true)

При stream: true ответ приходит в формате Server-Sent Events (SSE):

text

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"Квантовая"},"index":0}]}

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":" физика"},"index":0}]}

data: {"id":"chatcmpl-...","choices":[],"usage":{"prompt_tokens":25,"completion_tokens":150,"total_tokens":175}}

data: [DONE]

Для Claude и GPT Zukko сам включает stream_options.include_usage, поэтому последний фрагмент перед [DONE] несёт usage и пустой массив choices. Проверяйте длину choices перед обращением к choices[0]. Подробнее — Стриминг.

Node.js

POST /v1/images/generations