Каталог моделей

Каталог отдаёт точные slug, возможности, входные параметры и базовые цены моделей, доступных вашему API-ключу. Он обновляется без выпуска новой версии SDK, поэтому источник истины — живой ответ GET /v1/models, а не таблицы на этой странице.

Живой каталогСкопировать ссылку на раздел

Authorization: Bearer <CLIPIA_API_KEY>

curl -X GET "https://example.com/v1/models"

{  "data": [    {      "slug": "nano-banana-2",      "type": "image",      "name": "Nano Banana 2",      "capabilities": [        "text-to-image",        "image-to-image"      ],      "pricing": {        "credits": 12      }    },    {      "slug": "seedance-2-fast-i2v",      "type": "video",      "name": "Seedance 2 Fast",      "capabilities": [        "image-to-video"      ],      "pricing": {        "credits": 40,        "note": "зависит от длительности/разрешения"      }    }  ]}

curl https://api.clipia.ai/v1/models \
  -H "Authorization: Bearer $CLIPIA_KEY"

Каждая модель генерации в ответе содержит slug, type, name, capabilities и pricing. Состав может отличаться по окружению и меняться быстрее документации. limit и offset действуют только на модели генерации: LLM-модели приходят в ответе всегда.

Модели изображенийСкопировать ссылку на раздел

Модели видеоСкопировать ссылку на раздел

Модели аудиоСкопировать ссылку на раздел

Slug с косой чертойСкопировать ссылку на раздел

Десять моделей имеют slug вида семейство/модель. Такой slug передаётся в адрес как есть, без кодирования косой черты: POST /v1/models/google/imagen4, GET /v1/models/google/imagen4, POST /v1/models/google/imagen4/estimate. Кодированный вариант google%2Fimagen4 тоже принимается — так его отправляют SDK. В MCP-сервере его передают в параметр model инструмента generate_image или generate_video.

Для видео Grok Imagine есть и короткий slug grok-imagine-video-1-5 — оба адреса ведут на одну модель.

Схема одной моделиСкопировать ссылку на раздел

curl https://api.clipia.ai/v1/models/gpt-image-2 \
  -H "Authorization: Bearer $CLIPIA_KEY"

Передавайте внутри поля input при submit только ключи из input_schema. Если модель не найдена или неактивна, ответ — 404 с кодом not_found и сообщением model_not_found. Подписи и подсказки параметров (label, hint) приходят на английском.

Значение default в input_schema — умолчание исполнения: именно с ним запрос без этого параметра оценивается и исполняется. Сервер не подставляет умолчания за клиента в тело запроса, поэтому цена estimate для input без параметра и с параметром, равным default, совпадает.

Доступность новых моделейСкопировать ссылку на раздел

Модель доступна через API только после того, как её точный slug появился в GET /v1/models. Анонс или страница продукта этот сигнал не заменяют. Так, slug seedance-2-5-t2v и seedance-2-5-i2v для Seedance 2.5 включаются отдельно для каждого окружения и в боевом каталоге есть; пользовательский лендинг Seedance 2.5 открывается, только когда активны оба режима. Выключенная модель исчезает из списка, а запросы к ней получают 404 model_not_found. Всегда проверяйте живой каталог перед submit.