Список моделей
GET /v1/models — каталог моделей с интерактивной песочницей.
Получите каталог доступных моделей и их цены в кредитах.
Песочница
API-ключ в заголовке Authorization со схемой Key:
Authorization: Key clipia_live_xxxxxxxxxxxxxxxxxxxxxxПередавайте полную строку, включая префикс схемы Key и пробел.
Ключ создаётся в личном кабинете (Настройки → API-ключи) и показывается
один раз. Формат: clipia_live_… (боевой), clipia_test_… (песочница).
Sandbox / тестовый режим. Ключ с префиксом clipia_test_… работает в
песочнице: submit не списывает кредиты и не запускает реальную
генерацию — он мгновенно возвращает status: COMPLETED с детерминированным
mock-результатом (фиксированный sample-ассет на media.clipia.ai). Поле
cost показывает расчётную стоимость, но она не списывается. Вебхуки
приходят тем же подписанным механизмом (HMAC-SHA256). Режим предназначен
для отладки интеграции до подключения боевого ключа.
In: header
Response Body
curl -X GET "https://api.clipia.ai/v1/models"GET /v1/models возвращает каталог активных моделей Clipia — изображения и видео, — а GET /v1/models/:model отдаёт схему входа и тарификацию одной модели. Оба эндпоинта доступны любому валидному ключу, scope не требуется.
Список моделей
/v1/modelscurl https://api.clipia.ai/v1/models \
-H "Authorization: Bearer $CLIPIA_KEY"const { data } = await clipia.models.list();
console.log(data.map((m) => m.slug));catalog = client.models.list()
print([m["slug"] for m in catalog["data"]]){
"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": "зависит от длительности/разрешения" }
}
]
}Prop
Type
Схема одной модели
/v1/models/:modelcurl https://api.clipia.ai/v1/models/seedance-2-fast-i2v \
-H "Authorization: Bearer $CLIPIA_KEY"const model = await clipia.models.get('seedance-2-fast-i2v');
console.log(model.input_schema, model.pricing.credits);model = client.models.get("seedance-2-fast-i2v")
print(model["input_schema"], model["pricing"]["credits"]){
"slug": "seedance-2-fast-i2v",
"type": "video",
"name": "Seedance 2 Fast",
"capabilities": ["image-to-video"],
"input_schema": {
"image_url": { "type": "string", "required": true },
"prompt": { "type": "string", "required": false },
"duration": { "type": "number", "enum": [4, 8], "default": 4 },
"resolution": { "type": "string", "enum": ["480p", "720p", "1080p"], "default": "720p" },
"aspect_ratio": { "type": "string", "enum": ["16:9", "9:16", "1:1"] }
},
"pricing": { "credits": 40 }
}input_schema— описание входных параметров: ключ → дескриптор (type,required,enum,default). Эти ключи передаются внутриinputприsubmit.pricing.credits— базовая стоимость генерации в кредитах.
Точная цена за параметры
Тарификация в Clipia — фиксированная цена за операцию в кредитах, детерминированно вычисляемая из модели и параметров. Точную стоимость для конкретного набора параметров вернёт POST /v1/models/:model/estimate без постановки в очередь. Стоимость 1 кредита в деньгах через API не раскрывается — кредиты покупаются в личном кабинете.