API ROUTER.
Вход

Chat Completions (POST /v1/chat/completions)

Основной эндпоинт генерации текстовых ответов, рассуждений и выполнения функций по стандарту OpenAI API. Полная поддержка потоковой передачи (SSE), мультимодальности и вызова инструментов.

POST https://api-router.velar.plus/v1/chat/completions

Эндпоинт POST /v1/chat/completions является ядром большинства генеративных приложений. Он принимает массив сообщений диалога, поддерживает потоковую передачу токенов по протоколу Server-Sent Events (SSE) и автоматически распределяет вызовы между надежными апстрим-узлами с минимальным временем ожидания первого токена.

Формат запроса

Запрос отправляется методом POST с обязательным заголовком авторизации Authorization: Bearer <API_KEY> и заголовком Content-Type: application/json. Изучите доступные модели в разделе Модели нейросетей и полный список полей в статье Параметры и типы данных.

Параметр Тип Обязательный Описание
model string Да Идентификатор модели (например, anthropic/claude-sonnet или openai/gpt-mini)
messages array Да Массив сообщений диалога с объектами ролей (system, user, assistant, tool)
stream boolean Нет Включение потоковой передачи токенов через протокол Server-Sent Events (SSE). По умолчанию false
temperature number Нет Степень креативности генерации от 0.0 (строгая точность) до 2.0 (высокая вариативность). Дефолт: 1.0
max_tokens integer Нет Максимальное количество токенов в ответе. При превышении ответ прерывается статусом "length"

Пример вызова через cURL


curl https://api-router.velar.plus/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-or-v1-ваш-ключ" \
  -d '{
    "model": "anthropic/claude-sonnet",
    "messages": [
      {"role": "system", "content": "Вы лаконичный технический консультант."},
      {"role": "user", "content": "Сформулируйте суть закона Литтла в теории очередей."}
    ],
    "temperature": 0.2
  }'

Структура JSON-ответа


{
  "id": "chatcmpl-9x1vB87kLa901Z",
  "object": "chat.completion",
  "created": 1728392100,
  "model": "anthropic/claude-sonnet",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Закон Литтла утверждает: среднее число заявок в стационарной системе равно произведению интенсивности входящего потока на среднее время пребывания заявки в системе: L = λ * W."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 42,
    "total_tokens": 66
  }
}

Связанные разделы документации

Рекомендуем также изучить смежные технические руководства и спецификации: