Как работать с /v1/models

GET /v1/models возвращает все модели, доступные по вашему ключу: текстовые, картиночные, видео и TTS одним списком. Поле id (вида провайдер/модель, например google/gemini-2.5-flash) подставляется в параметр model остальных эндпоинтов. Запрос бесплатный и баланс не трогает. Описания, возможности и цены — в каталоге и на странице цен.

Как получить список?

Ответ — OpenAI-формат {"object": "list", "data": [...]}, каждая запись:

{
  "id": "google/gemini-2.5-flash",
  "object": "model",
  "created": 0,
  "owned_by": "google"
}

id — единственное поле, которое понадобится в работе: именно его ждёт параметр model в chat, images, videos и audio. Схема ответа целиком — в референсе /v1/models.

Какие семейства моделей есть?

Префикс id — провайдер: openai/*, anthropic/*, google/*, deepseek/*, yandex/*, kling/*. Семейство влияет на одну техническую деталь — маппинг лимита токенов (max_tokens ↔ max_completion_tokens), подробности в гайде по тексту. Всё остальное (формат запросов, ключ, биллинг) для всех семейств одинаковое.

Как понять, что умеет модель?

Сам список модальности не размечает — по id не всегда очевидно, чат это или генератор видео. Источник правды о возможностях, лимитах и назначении — каталог моделей: там у каждой модели пометки (текст, vision, изображения, видео, TTS) и актуальная цена.

Ошиблись эндпоинтом — API ответит честным 400 unsupported_capability (например, text-only модель не примет картинку). Разбор кодов — в гайде «Ошибки API».

Почему модель может исчезнуть из списка?

Провайдеры снимают модели с поддержки, мы добавляем новые — список живой. Поэтому:

• не хардкодьте id намертво: держите его в конфиге, чтобы менять без деплоя;
• обрабатывайте 404 model_not_found — это сигнал свериться со свежим GET /v1/models;
• при желании кешируйте список на своей стороне: он меняется редко, дёргать его на каждый запрос незачем.

Где смотреть цены?

Цены в рублях — на странице цен для разработчиков. Единицы у модальностей разные: текст и TTS тарифицируются по токенам, изображения — за картинку или по токенам (зависит от модели), видео — за секунду ролика. Сами суммы в документации не дублируем — страница цен всегда актуальнее.