> ## 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 v2.6

> Официальный Kling v2.6 с явным разделением обычных референсов и управления первым/последним кадром

* Асинхронный режим обработки, возвращает ID задачи для последующих запросов
* Поддерживает текст-в-видео, изображение-в-видео, явное управление первым/последним кадром и видео со звуком
* Поддерживает стандартный режим (720P) и профессиональный режим (1080P)
* Профессиональный режим поддерживает автоматическую генерацию аудио

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

<ParamField header="Authorization" type="string" required>
  Все эндпоинты требуют Bearer Token.

  ```
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

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

<ParamField body="model" type="string" required>
  Название модели генерации видео, фиксированное значение `kling-v2-6`.
</ParamField>

<ParamField body="prompt" type="string" required>
  Текстовый промпт, максимум **2500 символов**.
</ParamField>

<ParamField body="mode" type="string" default="std">
  Режим генерации.

  * `std` - стандартный режим (720P, только видео без звука)
  * `pro` - профессиональный режим (1080P, поддержка автоматической генерации аудио)
</ParamField>

<ParamField body="duration" type="integer" default="5">
  Длительность видео в секундах.

  Варианты: `5` или `10`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Соотношение сторон видео. Частые значения: `16:9`, `9:16`, `1:1`
</ParamField>

<ParamField body="reference_images" type="string[]">
  Обычные референсные изображения.

  * Это только референсы
  * Вторая картинка больше не интерпретируется автоматически как последний кадр
  * Для управления кадрами используйте `image_with_roles`
</ParamField>

<ParamField body="image_with_roles" type="object[]">
  Явный массив изображений с ролями для управления кадрами или смешанного ввода.

  <Expandable title="Показать поля image_with_roles">
    <ParamField body="url" type="string" required>
      Публично доступный URL изображения.
    </ParamField>

    <ParamField body="role" type="string" required>
      Роль изображения.

      Поддерживаемые значения:

      * `first_frame`
      * `last_frame`
      * `reference`
      * `reference_image`
    </ParamField>
  </Expandable>

  <Warning>
    Последний кадр отправляется только если `last_frame` явно указан в `image_with_roles`. Система больше не выводит его из `reference_images[1]`.
  </Warning>
</ParamField>

<ParamField body="negative_prompt" type="string">
  Негативный промпт для исключения нежелательного контента.
</ParamField>

<ParamField body="audio" type="boolean" default="false">
  Автоматически генерировать аудио.

  <Warning>
    Доступно только в `mode: "pro"`.
  </Warning>
</ParamField>

<ParamField body="watermark" type="boolean">
  Добавить водяной знак.
</ParamField>

## Правила ввода

| Форма ввода                                                                | Поведение          |
| -------------------------------------------------------------------------- | ------------------ |
| Только `reference_images`                                                  | Обычные референсы  |
| Только `image_with_roles` с ролями `first_frame` / `last_frame`            | Управление кадрами |
| Одновременное использование обоих полей или смешанные frame/reference роли | Смешанный режим    |

## Примеры

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

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

### Обычный референс

```json theme={null}
{
  "model": "kling-v2-6",
  "prompt": "Используй внешность персонажа из референса и добавь лёгкую улыбку",
  "reference_images": ["https://example.com/reference.jpg"],
  "mode": "std",
  "duration": 5
}
```

### Управление первым и последним кадром

```json theme={null}
{
  "model": "kling-v2-6",
  "prompt": "Таймлапс города с переходом от дня к ночи",
  "image_with_roles": [
    { "url": "https://example.com/day-city.jpg", "role": "first_frame" },
    { "url": "https://example.com/night-city.jpg", "role": "last_frame" }
  ],
  "mode": "pro",
  "duration": 5
}
```

### Смешанный ввод: референс и кадры

```json theme={null}
{
  "model": "kling-v2-6",
  "prompt": "Сохрани идентичность персонажа и выполни переход сцены",
  "reference_images": ["https://example.com/character-reference.jpg"],
  "image_with_roles": [
    { "url": "https://example.com/start-scene.jpg", "role": "first_frame" },
    { "url": "https://example.com/end-scene.jpg", "role": "last_frame" }
  ],
  "mode": "pro",
  "duration": 5
}
```

### Профессиональный режим + авто аудио

```json theme={null}
{
  "model": "kling-v2-6",
  "prompt": "Волны разбиваются о скалы, чайки кружат в небе, вдали маяк",
  "mode": "pro",
  "duration": 10,
  "audio": true,
  "aspect_ratio": "16:9"
}
```

<Note>
  Генерация видео является асинхронной задачей. Используйте [эндпоинт статуса видео-задачи](../../tasks/video-status) для запроса прогресса и результата.
</Note>