Документация API

Параметры

Общие параметры генерации, потоковой передачи, инструментов, эмбеддингов и картинок.

Скачать инструкцию для агента .md
ПараметрГдеЧто делает
modelallТочный id модели из каталога.
messageschat/messagesИстория диалога.
inputresponses/embeddingsПромпт для Responses или входной текст для эмбеддингов.
temperaturechat/responsesСлучайность: ниже строже, выше вариативнее.
top_pchat/responsesNucleus sampling. Обычно настраивают либо top_p, либо temperature.
max_tokenschat/messagesЛимит выходных токенов.
max_output_tokensresponsesЛимит выходных токенов для Responses.
streamchat/responsesПотоковая передача SSE.
stream_options.include_usagechatПросит usage в конце потока, если модель поддерживает.
tools/tool_choicechat/responsesВызов функций, если модель поддерживает.
response_formatchat/responsesJSON-режим или структурированный ответ, если поддерживается.
modalitieschat imageДля моделей Gemini для картинок: ["image", "text"].
promptimagesТекстовое описание картинки.
imagesimage editsИсходные картинки для /v1/images/edits.
messages.content[].image_urlchat imageКартинка на входе для моделей Gemini.
image_configchat imageНастройки картинки для Gemini: aspect_ratio и image_size.
quality/size/nimagesКачество, размер и количество картинок.
duration/resolution/aspect_ratiovideoДлина, разрешение и соотношение сторон для видео.
input_image/image_url/imagevideoИсходная картинка для видео по картинке.
audiovideoПризнак звука, если выбранная видео-модель это поддерживает.
dimensionsembeddingsРазмер вектора, если модель поддерживает.

Отладка параметров

  • Если запрос падает, оставьте только model, input или messages и авторизацию.
  • Потом возвращайте необязательные параметры по одному.
  • Некоторые провайдеры игнорируют неподдерживаемые поля, другие возвращают 400.
  • service_tier и похожие платные параметры могут быть отфильтрованы или отключены, чтобы не вызвать неожиданную доплату.