Skip to main content
GET /v1/models возвращает ту же модель, которую используют публичный каталог, Studio и MCP. Копируйте public_api_id в поле model; id в /v1/models содержит то же значение. api_aliases перечисляет опубликованные альтернативные ID. Сервер разрешает их в canonical_id, который сохраняет единую идентичность модели. Не собирайте ID из названия карточки.

​
Найдите модель

Для фильтрации доступны q, operation, enabled; страницы задаются page и page_size от 1 до 100. Ответ содержит pagination. Фильтрация выполняется до пагинации. Поиск q проверяет ID модели, опубликованные aliases, slug, название и разработчика без учёта регистра. Описания моделей в поиске не участвуют.
Для поиска добавьте q с ID, названием или разработчиком. Пустой результат после фильтра enabled=true означает, что по этим условиям нет доступной операции; не подставляйте имя похожей модели наугад.

​
Проверьте операцию

Проверяйте availability.operations для нужной операции. Поле enabled разрешает запуск, api_path задаёт endpoint, studio_supported сообщает о наличии интерфейса Studio. Embeddings доступны через API; отдельная форма Studio для них не предусмотрена. Проверяйте доступность непосредственно перед отправкой. Если нужная операция отключена, выберите другую доступную модель или вернитесь к запросу позже. Не заменяйте модель после отправки запроса с неизвестным исходом: сначала проверьте первоначальный результат.

​
Сравните цены

Каждая цена содержит amount_microrub, currency: RUB, unit, quantity, operation, condition. Например, unit=token и quantity=1000000 означают цену за миллион токенов. Ноль означает опубликованную нулевую цену; отсутствие цены не означает бесплатный запрос. Сравнивайте одинаковые операции и единицы: цена входных токенов не заменяет цену выходных, а цена за запрос не равна цене за миллион токенов. Для вывода суммы в рублях используйте точное форматирование. Для медиа оцените конкретный запрос до запуска.

​
Даты

dates.release и dates.supplier_added могут быть null: неизвестная дата не заменяется временем импорта. У известной даты есть value, precision (month, day или timestamp) и provenance. supplier_declared_release означает заявленную дату выпуска; supplier_added — дату добавления в каталог источника. Не показывайте месяц как точный день выпуска.