Работа с API

Запрос

Обязательные поля — model и messages. Идентификатор модели берётся из каталога в формате автор/модель.

{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {"role": "system", "content": "Отвечай кратко."},
    {"role": "user", "content": "Столица Норвегии?"}
  ],
  "temperature": 0.3,
  "max_tokens": 200
}

Если max_tokens не указан, длина ответа ограничивается 8192 токенами (или меньше, если столько не допускает модель). На время запроса на балансе резервируется сумма по этому пределу, после ответа списывается фактическая стоимость. Если остатка баланса или лимита ключа на такой резерв не хватает, предел уменьшается до покрываемого (но не ниже 256 токенов) — ответ тогда может оборваться раньше, с finish_reason: "length".

Стриминг

Передайте "stream": true — ответ придёт событиями server-sent events, по одному фрагменту на строку data:. Последнее событие — data: [DONE]. Расход и стоимость запроса — в финальном фрагменте, в поле usage.

Параметры

Поддерживаемые поля зависят от модели и перечислены на её странице в каталоге: temperature, top_p, max_tokens, stop, seed, response_format, tools, tool_choice, reasoning_effort и другие. Поля запроса передаются модели как есть. Общий справочник — в разделе «Параметры запроса».

Изображения и файлы на входе

Для моделей с модальностью входа «изображения» передавайте контент массивом частей: {"type": "image_url", "image_url": {"url": "…"}}. Поддерживаются ссылки и data-URL (base64). Если модель не принимает такой вход, запрос получает 422 с кодом unsupported_modality.