Перейти к содержимому
API ReferenceModels

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

GET /v1/models — актуальные AI-модели Clipia для изображений, видео и аудио.

Получите точные slug, возможности, входные параметры и цены моделей, доступных вашему API-ключу. Каталог обновляется без выпуска новой версии SDK.

Live-каталог

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 — единственный канонический источник текущей доступности. Состав может отличаться по окружению и меняться быстрее документации.

Проверено 7 августа 2026

Ниже — читаемый snapshot 64 активных публичных slug: 23 для изображений, 39 для видео и 2 для аудио. Перед отправкой задачи всё равно получите live-каталог.

Модели изображений

СемействоПубличные API slug
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

Модели видео

СемействоПубличные API slug
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

Модели аудио

СемействоПубличный API slug
Gemini TTSgemini-3-1-flash-tts, gemini-2-5-pro-tts
Suno Musicsuno-music

Схема одной модели

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

Ответ содержит slug, type, name, capabilities, input_schema и pricing. Передавайте только ключи из input_schema внутри поля input при submit.

Prop

Type

Не фиксируйте схему в коде по этой странице

У вариантов одного семейства могут отличаться обязательные поля, длительность, разрешение и референсы. Получайте input_schema для точного slug и вызывайте POST /v1/models/:model/estimate перед генерацией.

Доступность новых моделей

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