> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Генерация видео Kling v3 Omni

> Генерация видео Kling v3 Omni с официальными Omni-ссылками: image_list, video_list и element_list

> [!NOTE]
>
> **Для пользователей из материкового Китая:** используйте `https://toapis.cn` в качестве эндпоинта (Base URL). Замените `https://toapis.com` на `https://toapis.cn` во всех примерах этого документа.

* Асинхронный API, после отправки возвращает ID задачи
* Использует официальные Omni-структуры ссылок: `image_list`, `video_list` и `element_list`
* `mode=std` соответствует 720P, `mode=pro` соответствует 1080P
* `audio=true` генерирует видео со звуком и тарифицируется как Sound
* Запросы с `video_list` тарифицируются как Video
* `audio` и `video_list` взаимоисключающие

> [!WARNING]
>
> Используйте публично доступные URL изображений и видео. Не передавайте base64-данные медиа напрямую. Для локальных изображений сначала используйте [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md).

## Авторизация

**Authorization** `string` *required*

Все эндпоинты требуют Bearer Token.

```
Authorization: Bearer YOUR_API_KEY
```

## Параметры запроса

**model** `string` *required*

Название модели генерации видео, фиксированное значение `kling-v3-omni`.

**prompt** `string` *required*

Текстовый промпт. Используйте официальные Omni-плейсхолдеры для ссылок на входные материалы:

* `<<<image_N>>>` ссылается на `metadata.image_list`
* `<<<video_N>>>` ссылается на `video_list`
* `<<<element_N>>>` ссылается на `metadata.element_list`

Пример: `"Пусть персонаж на <<<image_1>>> машет рукой в камеру"`

> [!NOTE]
>
> Порядок списков должен совпадать с порядком соответствующих плейсхолдеров в prompt. Система не добавляет первый кадр и не вставляет плейсхолдеры автоматически.

**mode** `string` (default: std)

Режим генерации: `std` для 720P или `pro` для 1080P.

**duration** `integer` (default: 5)

Длительность видео в секундах. Возможные значения: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`.

**aspect\_ratio** `string` (default: 16:9)

Соотношение сторон видео. Частые значения: `16:9`, `9:16`, `1:1`.

**audio** `boolean` (default: false)

Генерировать ли видео со звуком.

> [!WARNING]
>
> `audio` и `video_list` взаимоисключающие. Не передавайте `audio=true`, если указан `video_list`.

**video\_list** `object[]`

Официальный Omni-список референс-видео. В prompt используйте `<<<video_1>>>`, `<<<video_2>>>` и так далее.

**Поля объекта video\_list**

**video\_url** `string` *required*

URL референс-видео, публично доступный.

**refer\_type** `string` (default: base)

Тип референса: `base` для редактируемого исходного видео или `feature` для референса движения/особенностей.

**keep\_original\_sound** `string` (default: no)

Сохранять ли оригинальный звук видео: `yes` или `no`.

**metadata** `object`

Расширенные параметры.

**Поля metadata**

**image\_list** `object[]`

Официальный Omni-список изображений. В prompt используйте `<<<image_1>>>`, `<<<image_2>>>` и так далее.

**Поля объекта image\_list**

**image\_url** `string` *required*

URL изображения, публично доступный.

**type** `string`

Тип изображения. Для первого/последнего кадра используйте `first_frame` или `end_frame`. Если указан `end_frame`, также требуется `first_frame`.

**element\_list** `object[]`

Официальный Omni-список субъектов/ролей. В prompt используйте `<<<element_1>>>`, `<<<element_2>>>` и так далее.

**Поля объекта element\_list**

**url** `string` *required*

URL изображения субъекта, ассета персонажа или другого поддерживаемого материала.

**type** `string`

Тип элемента, например `image` или `video`.

**role** `string`

Ролевая семантика, поддерживаемая официальной моделью.

**watermark** `boolean`

Добавить водяной знак.

## Синтаксис Omni-ссылок

| Синтаксис | Описание |
| - | - |
| `<<<image_1>>>` | Ссылка на первый элемент `metadata.image_list` |
| `<<<video_1>>>` | Ссылка на первый элемент `video_list` |
| `<<<element_1>>>` | Ссылка на первый элемент `metadata.element_list` |

> [!WARNING]
>
> Порядок `image_list`, `video_list` и `element_list` должен совпадать с порядком соответствующих плейсхолдеров в `prompt`.

## Примеры

### Текст-в-видео

```json theme={null}
{
  "model": "kling-v3-omni",
  "prompt": "Золотистый ретривер бежит по пляжу на закате, кинематографическое качество",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}
```

### Ссылка на изображение

```json theme={null}
{
  "model": "kling-v3-omni",
  "prompt": "Пусть персонаж на <<<image_1>>> машет рукой в камеру",
  "mode": "pro",
  "duration": 5,
  "metadata": {
    "image_list": [
      {"image_url": "https://example.com/portrait.jpg"}
    ]
  }
}
```

### Первый и последний кадр

```json theme={null}
{
  "model": "kling-v3-omni",
  "prompt": "Переход от <<<image_1>>> к <<<image_2>>>",
  "mode": "pro",
  "duration": 5,
  "metadata": {
    "image_list": [
      {"image_url": "https://example.com/start.jpg", "type": "first_frame"},
      {"image_url": "https://example.com/end.jpg", "type": "end_frame"}
    ]
  }
}
```

### Референс-видео

```json theme={null}
{
  "model": "kling-v3-omni",
  "prompt": "Заменить фон в <<<video_1>>> на закат у моря",
  "mode": "std",
  "video_list": [
    {
      "video_url": "https://example.com/source-video.mp4",
      "refer_type": "base",
      "keep_original_sound": "no"
    }
  ]
}
```

### Субъект и референс движения

```json theme={null}
{
  "model": "kling-v3-omni",
  "prompt": "Пусть <<<element_1>>> повторяет движение из <<<video_1>>>",
  "mode": "pro",
  "video_list": [
    {
      "video_url": "https://example.com/motion-reference.mp4",
      "refer_type": "feature",
      "keep_original_sound": "no"
    }
  ],
  "metadata": {
    "element_list": [
      {"url": "https://example.com/character.jpg", "type": "image", "role": "subject"}
    ]
  }
}
```

> [!NOTE]
>
> Генерация видео асинхронная. Используйте [статус видео задачи](https://docs.toapis.com/docs/ru/api-reference/tasks/video-status.md), чтобы получить прогресс и результат.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.