> ## 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 с явным разделением обычных референсов и управления первым/последним кадром

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

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

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

**Authorization** `string` *required*

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

```
Authorization: Bearer YOUR_API_KEY
```

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

**model** `string` *required*

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

**prompt** `string` *required*

Текстовый промпт, максимум **2500 символов**.

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

Режим генерации.

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

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

Длительность видео в секундах.

Варианты: `5` или `10`

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

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

**reference\_images** `string[]`

Обычные референсные изображения.

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

**image\_with\_roles** `object[]`

Явный массив изображений с ролями для управления кадрами или смешанного ввода.

**Показать поля image\_with\_roles**

**url** `string` *required*

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

**role** `string` *required*

Роль изображения.

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

* `first_frame`
* `last_frame`
* `reference`
* `reference_image`

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

**negative\_prompt** `string`

Негативный промпт для исключения нежелательного контента.

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

Автоматически генерировать аудио.

> [!WARNING]
>
> Доступно только в `mode: "pro"`.

**watermark** `boolean`

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

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

| Форма ввода | Поведение |
| - | - |
| Только `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]
>
> Генерация видео является асинхронной задачей. Используйте [эндпоинт статуса видео-задачи](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.