Создать chat completion

OpenAI-совместимый запрос. При stream: true ответ передаётся как Server-Sent Events. Audio-output модели вызываются здесь же с modalities: ["text", "audio"]; аудиоданные приходят в message.audio или delta.audio. Поддерживаемые параметры модели перечислены в supported_parameters каталога /models. Значения по умолчанию, если известны, возвращаются в default_parameters. Не передавайте необязательный параметр, чтобы использовать значение по умолчанию провайдера. Явные нулевые значения передаются без изменений, кроме описанного ниже исключения для gorouter/free. Поддержка параметров зависит от модели и провайдера. Виртуальная модель gorouter/free доступна только здесь. Она не списывает баланс, поддерживает текст, streaming, function calling и structured output. По умолчанию лимиты составляют 8192 входных и 8192 выходных токенов, n=1, два запроса в минуту и одна активная генерация на аккаунт; актуальные значения публикуются в каталоге модели. Для совместимости с клиентами gorouter/free принимает presence_penalty: 0 и удаляет поле перед отправкой провайдеру. Ненулевые значения этого параметра не поддерживаются.

Авторизация

bearerAuth

AuthorizationBearer <ключ>

Inference key для запросов к моделям, management key для Management API.

In: header

Заголовки

X-GoRouter-Data-Collection?"deny"

Значение deny исключает запрос из добровольного сбора GoRouter и скидки. Не может включить сбор без согласия в кабинете.

Value in

"deny"

Тело запроса

application/json

Типы TypeScript

Use the request body type in TypeScript.

model*string

ID включённой модели или latest-алиас из каталога, например ~deepseek/deepseek-v4-flash-latest. gorouter/free появляется только когда бесплатный маршрут включён оператором. Конкретная модель фиксируется до расчёта резерва; поле model в ответе содержит публичный ID.

messages*array<>

max_tokens?integer

Максимум выходных токенов, включая скрытые рассуждения модели. Без явного значения задаётся конечный лимит по доступному бюджету и возможностям маршрута. В защищённом режиме указанный лимит также может быть уменьшен до доступного бюджета; применённое значение возвращается в x-gorouter-max-output-tokens. Резерв растёт по мере выполнения. Если сервис модели отклоняет слишком большой лимит, error.message содержит доступные подробности для его корректировки.

Range1 <= value

stream?boolean

true возвращает SSE; false или отсутствие поля возвращает готовый JSON.

Defaultfalse

modalities?array<>

Для audio-output модели передайте text и audio. Обычный текстовый запрос может не передавать поле.

audio?

Настройки разговорной audio-модели. Для музыкальных моделей с фиксированной ценой за song/clip поле не требуется.

top_k?integer

Число наиболее вероятных токенов для выбора следующего. 0 отключает ограничение Top K.

Range0 <= value

frequency_penalty?number

Штраф с учётом частоты токена в тексте. Положительные значения уменьшают повторы, отрицательные поощряют их; 0 отключает штраф.

Range-2 <= value <= 2

presence_penalty?number

Штраф за уже встречавшиеся токены, независимо от числа повторов. Положительные значения поощряют новые темы, отрицательные — повторение; 0 отключает штраф. Для gorouter/free разрешено только значение 0; поле удаляется перед отправкой провайдеру.

Range-2 <= value <= 2

repetition_penalty?number

Множитель штрафа за повторение токенов. 1 — без штрафа, значения выше 1 уменьшают повторы, ниже 1 поощряют их.

Range0 <= value <= 2

min_p?number

Минимальная вероятность токена относительно самого вероятного. 0 отключает фильтр; большие значения сужают выбор.

Range0 <= value <= 1

top_a?number

Адаптивный порог выбора токена, равный top_a, умноженному на квадрат вероятности самого вероятного токена. 0 отключает фильтр.

Range0 <= value <= 1

provider?

Без sort и order провайдер выбранной модели определяется автоматически с учётом цены и доступности. Переключение при ошибке разрешено по умолчанию, в пределах настроек приватности и доступного бюджета. Резерв учитывает максимальную стоимость допущенных вариантов; списание — фактическое использование. Подробнее: /docs/models.

[key: string]?any

Ответ

`application/json`

curl -X POST "https://example.com/chat/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "deepseek/deepseek-v4-flash-0731",    "messages": [      {        "role": "user",        "content": "Привет!"      }    ],    "max_tokens": 1024  }'

{}

Создать chat completion

Авторизация

Заголовки

Тело запроса

Ответ

200application/json

400application/json

401application/json

402application/json

403application/json

404application/json

408application/json

412application/json

413application/json

422application/json

429application/json

500application/json

502application/json

503application/json

504application/json

524application/json

529application/json

defaultapplication/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`