> ## 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

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

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

* Асинхронный API задач, после отправки возвращает ID задачи
* Поддерживает текст-в-видео, изображение-в-видео, явное управление первым/последним кадром и видео со звуком
* `mode=std` соответствует 720P, `mode=pro` соответствует 1080P
* `audio=true` включает генерацию звука и тарифицируется как Sound
* `duration` поддерживает `3s`, `4s`, `5s`, `6s`, `7s`, `8s`, `9s`, `10s`, `11s`, `12s`, `13s`, `14s`, `15s`

> [!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`.

**prompt** `string` *required*

Текстовый промпт. Опишите объект, действие, сцену, движение камеры и стиль.

**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`

**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]`.

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

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

**metadata** `object`

Дополнительные параметры.

**Показать поля metadata**

**negative\_prompt** `string`

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

**watermark** `boolean`

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

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

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

## Примеры

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

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

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

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

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

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

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

```json theme={null}
{
  "model": "kling-v3",
  "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-v3",
  "prompt": "Певец выступает на сцене, толпа аплодирует, мигают огни",
  "mode": "std",
  "duration": 5,
  "audio": true
}
```

> [!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.