Список моделей
GET /v1/models — каталог моделей с интерактивной песочницей.
Получите каталог доступных моделей и их цены в кредитах.
Песочница
API-ключ в заголовке Authorization со схемой Bearer:
Authorization: Bearer clipia_live_xxxxxxxxxxxxxxxxxxxxxxПередавайте полную строку, включая префикс схемы Bearer и пробел.
Также принимаются Authorization: Key <ключ> и заголовок
X-Api-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"{
"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": "зависит от длительности/разрешения"
}
}
]
}{
"error": {
"type": "invalid_request_error",
"code": "invalid_api_key",
"message": "API-ключ отсутствует, неверный или отозван."
}
}{
"error": {
"type": "invalid_request_error",
"code": "rate_limit_exceeded",
"message": "Превышен лимит запросов. Повторите позже."
}
}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 не раскрывается — кредиты покупаются в личном кабинете.