---
title: Каталог моделей
description: GET /v1/models — список моделей Clipia для изображений, видео и аудио с точными slug, схемой параметров и ценой, включая slug с косой чертой.
icon: Boxes
---

Каталог отдаёт точные slug, возможности, входные параметры и базовые цены моделей, доступных вашему API-ключу. Он обновляется без выпуска новой версии SDK, поэтому источник истины — живой ответ `GET /v1/models`, а не таблицы на этой странице.

<Cards>
  <Card title="Seedance 2.5 API" href="/ru/docs/api-reference/models/seedance-2-5">
    Точные T2V/I2V slug, параметры и проверка доступности в живом каталоге.
  </Card>
  <Card title="Отправить генерацию" href="/ru/docs/api-reference/submit">
    Универсальный POST-запрос для любой активной модели.
  </Card>
  <Card title="Рассчитать стоимость" href="/ru/docs/api-reference/estimate">
    Точная цена для выбранной модели и параметров до запуска.
  </Card>
</Cards>

## Живой каталог

<Callout type="info" title="Для проб — тестовый ключ">
В форму ниже вставляйте ключ `clipia_test_…`: он не списывает кредиты и не вызывает модели, а ответ приходит в том же формате. Форма запоминает ключ в этом браузере, поэтому боевой `clipia_live_…` — серверный секрет — в неё не вводите. Подробнее — [«Тестовый режим»](/ru/docs/getting-started/sandbox).
</Callout>

<ApiPlayground path="/v1/models" method="get" />

<Method name="GET" path="/v1/models" />

| Параметр запроса | По умолчанию | Что делает |
| --- | --- | --- |
| `limit` | `100` | сколько моделей генерации вернуть |
| `offset` | `0` | сколько моделей генерации пропустить |

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl https://api.clipia.ai/v1/models \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

</Tab>
<Tab value="TypeScript">

```ts
const { data } = await clipia.models.list();

// В списке есть и LLM-модели без slug — оставляем только модели генерации
const media = data.filter((model) => "slug" in model && model.slug);
console.log(media.map(({ slug, type }) => ({ slug, type })));
```

</Tab>
<Tab value="Python">

```python
catalog = clipia.models.list()

# В списке есть и LLM-модели без slug — оставляем только модели генерации
media = [m for m in catalog["data"] if m.get("slug")]
print([(m["slug"], m["type"]) for m in media])
```

</Tab>
</Tabs>

Каждая модель генерации в ответе содержит `slug`, `type`, `name`, `capabilities` и `pricing`. Состав может отличаться по окружению и меняться быстрее документации. `limit` и `offset` действуют только на модели генерации: LLM-модели приходят в ответе всегда.

<Callout type="info" title="LLM-модели в том же списке">
[AI Gateway](/ru/docs/llm-gateway) включён, поэтому ответ приходит в формате списка OpenAI (`object: "list"`), и первыми в `data` идут LLM-модели: у них есть `id`, но нет `slug`. Модели генерации идут следом и, кроме `slug`, получают поля `id`, `object`, `created` и `owned_by`. Фильтруйте элементы по наличию `slug`, как в примерах выше. `GET /v1/models/{id}` для LLM-модели отдаёт запись того же вида, что и в списке. Подробнее о LLM-моделях — в разделе [«Модели и цены LLM»](/ru/docs/llm-gateway/models).
</Callout>

<Callout type="info" title="Цены">
Цены актуальны на ноябрь 2026 года. Точная стоимость всегда видна на кнопке запуска до списания. Через API цену конкретной задачи возвращает [`POST /v1/models/{model}/estimate`](/ru/docs/api-reference/estimate).
</Callout>

<Callout type="info" title="Снимок каталога">
Ниже — читаемый снимок живого каталога на 4 ноября 2026 года: 90 активных публичных моделей, из них 27 для изображений, 55 для видео и 8 для аудио. Все они вызываются через MCP и, кроме `midjourney/v8.1`, через REST API; у 10 из них slug с косой чертой — как передавать такой slug, описано в разделе [«Slug с косой чертой»](#mcp-only). Перед отправкой задачи всё равно получите живой каталог.
</Callout>

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

| Семейство | Slug для REST API |
| --- | --- |
| FLUX 2 | `flux-2-flex`, `flux-2-pro` |
| FLUX 3 | `flux-3-klein` |
| FLUX Kontext | `flux-kontext-max`, `flux-kontext-pro` |
| GPT Image | `gpt-image-1-5`, `gpt-image-2`, `gpt-image-2-5-flare`, `gpt-image-2-5-sunburst`, `gpt-image-2-6-flare`, `gpt-image-2-6-sunburst` |
| Imagen 4 | `google/imagen4`, `google/imagen4-fast`, `google/imagen4-ultra` |
| Grok Imagine | `grok-imagine/text-to-image`, `grok-imagine/image-to-image` |
| Midjourney | `midjourney/v7`, `midjourney/v8.1` |
| Nano Banana | `nano-banana-2`, `nano-banana-2-1`, `nano-banana-pro` |
| Qwen Image | `qwen-image-2` |
| Seedream | `seedream-4-5`, `seedream-5-0-lite`, `seedream-5-0-pro`, `seedream-v4`, `seedream-v4-edit` |
| Wan Image | `wan-2-7-image` |
| Z-Image | `z-image` |

## Модели видео

| Семейство | Slug для REST API |
| --- | --- |
| Gemini Omni 1.2 | `gemini-omni-video` |
| Grok Imagine | `grok-imagine-video-1-5`, `grok-imagine/text-to-video`, `grok-imagine/image-to-video` |
| Hailuo | `hailuo-02`, `hailuo-02-standard`, `hailuo-2-3`, `hailuo-2-3-fast` |
| HappyHorse | `happy-horse-t2v`, `happy-horse-i2v`, `happy-horse-r2v`, `happy-horse-edit` |
| HeyGen Video | `heygen-video-t2v`, `heygen-video-i2v`, `heygen-video-r2v` |
| Kling 2.5 | `kling-v2-5-turbo-text-to-video-pro`, `kling-v2-5-turbo-image-to-video-pro` |
| Kling 2.6 | `kling-2-6-text-to-video`, `kling-2-6-image-to-video`, `kling-2-6-motion-control` |
| Kling 3 | `kling-3-text-to-video`, `kling-3-image-to-video`, `kling-3-multi-shot`, `kling-3-motion-control` |
| Kling 4.0 | `kling-4-t2v`, `kling-4-i2v`, `kling-4-r2v` |
| Kling 4.0 Flash | `kling-4-flash-t2v`, `kling-4-flash-i2v`, `kling-4-flash-r2v` |
| Kling O3 | `kling-o3-t2v`, `kling-o3-i2v`, `kling-o3-r2v`, `kling-o3-transform` |
| Kling Lip Sync | `kling-lip-sync` |
| Midjourney Video | `midjourney/v7-image-to-video` |
| MiniMax H3 | `h3-t2v`, `h3-i2v` |
| OmniHuman | `omnihuman-2` |
| Seedance 1.5 | `seedance-1-5-text-to-video`, `seedance-1-5-image-to-video` |
| Seedance 2.0 | `seedance-2-t2v`, `seedance-2-i2v`, `seedance-2-fast-t2v`, `seedance-2-fast-i2v`, `seedance-2-mini-t2v`, `seedance-2-mini-i2v` |
| Seedance 2.5 | `seedance-2-5-t2v`, `seedance-2-5-i2v` |
| Veo | `veo3-fast`, `veo3-lite`, `veo3-quality` |
| Wan | `wan-2-5`, `wan-2-7`, `wan-2-7-image-to-video` |
| Wan 3.0 | `wan-3-0`, `wan-3-0-i2v`, `wan-3-0-r2v` |

## Модели аудио

| Семейство | Slug для REST API |
| --- | --- |
| ElevenLabs | `eleven-v4`, `eleven-v4-turbo` |
| Gemini TTS | `gemini-3-1-flash-tts`, `gemini-2-5-pro-tts` |
| Suno | `suno-music`, `suno-v6`, `suno-v6-mini`, `suno-v6-wild` |

## Slug с косой чертой [#mcp-only]

Десять моделей имеют slug вида `семейство/модель`. Такой slug передаётся в адрес как есть, без кодирования косой черты: `POST /v1/models/google/imagen4`, `GET /v1/models/google/imagen4`, `POST /v1/models/google/imagen4/estimate`. Кодированный вариант `google%2Fimagen4` тоже принимается — так его отправляют SDK. В [MCP-сервере](/ru/docs/mcp) его передают в параметр `model` инструмента `generate_image` или `generate_video`.

| Тип | Семейство | Slug |
| --- | --- | --- |
| изображение | Imagen 4 | `google/imagen4`, `google/imagen4-fast`, `google/imagen4-ultra` |
| изображение | Grok Imagine | `grok-imagine/text-to-image`, `grok-imagine/image-to-image` |
| изображение | Midjourney | `midjourney/v7`, `midjourney/v8.1` |
| видео | Grok Imagine | `grok-imagine/text-to-video`, `grok-imagine/image-to-video` |
| видео | Midjourney Video | `midjourney/v7-image-to-video` |

Для видео Grok Imagine есть и короткий slug `grok-imagine-video-1-5` — оба адреса ведут на одну модель.

<Callout type="warn" title="midjourney/v8.1 через REST не запускается">
В slug `midjourney/v8.1` есть точка, а проверка формата у `POST /v1/models/:model` допускает только строчные буквы, цифры, дефис и одну косую черту: отправка возвращает `400 invalid_request` с сообщением `invalid_model`. Карточка `GET /v1/models/midjourney/v8.1` и оценка стоимости при этом работают. Пока проверка не исправлена, запускайте эту модель через [MCP](/ru/docs/mcp) или выбирайте `midjourney/v7`.
</Callout>

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

<Method name="GET" path="/v1/models/:model" />

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

Передавайте внутри поля `input` при submit только ключи из `input_schema`. Если модель не найдена или неактивна, ответ — `404` с кодом `not_found` и сообщением `model_not_found`. Подписи и подсказки параметров (`label`, `hint`) приходят на английском.

<TypeTable
  type={{
    slug: { type: 'string', description: 'Точный идентификатор для POST /v1/models/:model' },
    type: { type: 'string', description: 'image, video или audio' },
    name: { type: 'string', description: 'Публичное название модели' },
    capabilities: { type: 'string[]', description: 'Поддерживаемые режимы генерации' },
    text_limits: { type: 'object', description: '{ min_chars, max_chars } — границы длины текста озвучки; есть только у моделей озвучки. Текст вне границ отклоняется кодом 400 до резерва кредитов' },
    input_schema: { type: 'object', description: '{ parameters: [{ name, type, required, default, options, validation, min, max, … }] } — актуальные параметры, допустимые значения и умолчания исполнения' },
    pricing: { type: 'object', description: 'Эталонная цена в кредитах: credits — цена одного запуска с умолчаниями; estimate_required: true — цена зависит от входа (длина исходника или текста), credits нет, нужен estimate; available: false — цену сейчас посчитать не удалось, note объясняет причину. У моделей озвучки credits даётся за 1000 символов (billing_unit: characters, unit_size: 1000, rounding: ceil, minimum_credits: 1)' }
  }}
/>

Значение `default` в `input_schema` — умолчание исполнения: именно с ним запрос без этого параметра оценивается и исполняется. Сервер не подставляет умолчания за клиента в тело запроса, поэтому цена `estimate` для `input` без параметра и с параметром, равным `default`, совпадает.

<Callout type="warn" title="Не фиксируйте схему в коде по этой странице">
У вариантов одного семейства могут отличаться обязательные поля, длительность, разрешение и референсы. Получайте `input_schema` для точного slug и вызывайте `POST /v1/models/:model/estimate` перед генерацией.
</Callout>

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

Модель доступна через API только после того, как её точный slug появился в `GET /v1/models`. Анонс или страница продукта этот сигнал не заменяют. Так, slug `seedance-2-5-t2v` и `seedance-2-5-i2v` для [Seedance 2.5](/ru/docs/api-reference/models/seedance-2-5) включаются отдельно для каждого окружения и в боевом каталоге есть; пользовательский [лендинг Seedance 2.5](/ru/video-models/seedance-2-5) открывается, только когда активны оба режима. Выключенная модель исчезает из списка, а запросы к ней получают `404 model_not_found`. Всегда проверяйте живой каталог перед submit.