Skip to content
API ReferenceModels

Model catalog

GET /v1/models — current Clipia AI models for image, video, and audio generation.

Get the exact slugs, capabilities, input parameters, and prices available to your API key. The catalog can change without a new SDK release.

Live catalog

GET
/v1/models
Authorization<token>

API-ключ в заголовке Authorization со схемой Bearer:

Authorization: Bearer clipia_live_xxxxxxxxxxxxxxxxxxxxxx

Передавайте полную строку, включая префикс схемы Bearer и пробел. Также принимаются Authorization: Key <ключ> и заголовок X-Api-Key: <ключ> — выбирайте удобную схему. Ключ создаётся в консоли разработчика (clipia.ai/developer, вкладка «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
curl https://api.clipia.ai/v1/models \
  -H "Authorization: Bearer $CLIPIA_KEY"
const { data } = await clipia.models.list();
console.log(data.map(({ slug, type }) => ({ slug, type })));
catalog = client.models.list()
print([(model["slug"], model["type"]) for model in catalog["data"]])

GET /v1/models is the canonical source of current availability. Results can vary by environment and change faster than this page.

Audited on August 7, 2026

The readable snapshot below covers 64 active public slugs: 23 image, 39 video, and 2 audio models. Always fetch the live catalog before submitting a job.

Image models

FamilyPublic API slugs
FLUX 2flux-2-flex, flux-2-pro
FLUX Kontextflux-kontext-max, flux-kontext-pro
Imagen 4google/imagen4, google/imagen4-fast, google/imagen4-ultra
GPT Imagegpt-image-1-5, gpt-image-2
Grok Imaginegrok-imagine/text-to-image, grok-imagine/image-to-image
Higgsfield Soulhiggsfield-soul
Midjourneymidjourney/v7
Nano Banananano-banana-2, nano-banana-pro
Qwen Imageqwen-image-2
Seedreamseedream-4-5, seedream-5-0-lite, seedream-5-0-pro, seedream-v4, seedream-v4-edit
Wan Imagewan-2-7-image
Z-Imagez-image

Video models

FamilyPublic API slugs
Gemini Omnigemini-omni-video
Grok Imaginegrok-imagine/text-to-video, grok-imagine/image-to-video, grok-imagine-video-1-5
Hailuohailuo-02, hailuo-02-standard, hailuo-2-3, hailuo-2-3-fast
HappyHorsehappy-horse-t2v, happy-horse-i2v, happy-horse-r2v, happy-horse-edit
Kling 2.5kling, kling-v2-5, kling-v2-5-turbo-text-to-video-pro, kling-v2-5-turbo-image-to-video-pro
Kling 2.6kling-2-6-text-to-video, kling-2-6-image-to-video, kling-2-6-motion-control
Kling 3kling-3-text-to-video, kling-3-image-to-video, kling-3-multi-shot, kling-3-motion-control
Kling Lip Synckling-lip-sync
Midjourney Videomidjourney/v7-image-to-video
Seedance 1.5seedance-1-5-text-to-video, seedance-1-5-image-to-video
Seedance 2.0seedance-2-t2v, seedance-2-i2v, seedance-2-fast-t2v, seedance-2-fast-i2v, seedance-2-mini-t2v, seedance-2-mini-i2v
Veoveo3-fast, veo3-lite, veo3-quality
Wanwan-2-5, wan-2-7, wan-2-7-image-to-video

Audio models

FamilyPublic API slug
Gemini TTSgemini-3-1-flash-tts, gemini-2-5-pro-tts
Suno Musicsuno-music

Single-model schema

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

The response includes slug, type, name, capabilities, input_schema, and pricing. Pass only keys from input_schema inside the submit request's input.

Prop

Type

Do not hard-code a schema from this page

Variants in one family can have different required fields, durations, resolutions, and reference inputs. Fetch input_schema for the exact slug and call POST /v1/models/:model/estimate before generation.

New model availability

A model is API-ready only after its exact slug appears in GET /v1/models. A product landing or announcement is not an API availability signal. Exact slugs seedance-2-5-t2v and seedance-2-5-i2v are prepared for Seedance 2.5, but activation can be controlled per environment. The customer-facing Seedance 2.5 landing opens only when both modes are active. Always check the live catalog before submit.