List models
GET /v1/models — model catalogue with an interactive playground.
Get the catalogue of available models and their prices in credits.
Playground
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 returns the catalog of active Clipia models — images and video — and GET /v1/models/:model returns one model's input schema and pricing. Both endpoints are available to any valid key, no scope required.
List models
/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": "varies with duration/resolution" }
}
]
}Prop
Type
Single model schema
/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_schemadescribes the input parameters: key → descriptor (type,required,enum,default). Pass these keys insideinputatsubmit.pricing.creditsis the base generation cost in credits.
Exact price for parameters
Clipia pricing is a fixed per-operation cost in credits, deterministically computed from the model and parameters. For the exact cost of a specific parameter set, call POST /v1/models/:model/estimate without enqueueing. The monetary value of one credit is not exposed via the API — credits are purchased in your account.