Chat Completions: POST /v1/chat/completions

Запрос

curl https://tokventa.tech/v1/chat/completions \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-flash",
    "messages": [
      {"role": "system", "content": "Отвечай кратко."},
      {"role": "user", "content": "Что такое API-шлюз?"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

Параметры

• model — ID модели из списка доступных ключу.
• messages — массив ролей system / user / assistant. Для моделей со зрением content может быть массивом частей: [{type:"text",text:"…"},{type:"image_url",image_url:{url:"…"}}].
• temperature, top_p, max_tokens, stop, presence_penalty — как в OpenAI API.
• stream: true — потоковый ответ SSE, см. /docs/streaming.

Ответ

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": 1758000000,
  "model": "qwen3.8-flash",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "API-шлюз — это…" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 24, "completion_tokens": 120, "total_tokens": 144 }
}

Списания считаются по полю usage: (prompt_tokens × цена входа + completion_tokens × цена выхода) / 1 000 000 в рублях. Цены каждой модели — /pricing.

Особые случаи

• Модели генерации изображений можно вызывать и через chat/completions — картинка придёт в choices[0].message.content частью image_url (генерация занимает 30–90 с, стриминг не поддерживается).
• Ошибки и их значения — /docs/errors.

Базовый URL API: https://tokventa.tech/v1 · Каталог моделей · Цены · Получить ключ