Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
Генерация видео Kling v2.6
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "mode": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "reference_images": [
    "<string>"
  ],
  "image_with_roles": [
    {
      "url": "<string>",
      "role": "<string>"
    }
  ],
  "negative_prompt": "<string>",
  "audio": true,
  "watermark": true
}
'
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддерживает текст-в-видео, изображение-в-видео, явное управление первым/последним кадром и видео со звуком
  • Поддерживает стандартный режим (720P) и профессиональный режим (1080P)
  • Профессиональный режим поддерживает автоматическую генерацию аудио

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

​
Authorization
string
обязательно
Все эндпоинты требуют Bearer Token.
Authorization: Bearer YOUR_API_KEY

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

​
model
string
обязательно
Название модели генерации видео, фиксированное значение kling-v2-6.
​
prompt
string
обязательно
Текстовый промпт, максимум 2500 символов.
​
mode
string
по умолчанию:"std"
Режим генерации.
  • std - стандартный режим (720P, только видео без звука)
  • pro - профессиональный режим (1080P, поддержка автоматической генерации аудио)
​
duration
integer
по умолчанию:"5"
Длительность видео в секундах.Варианты: 5 или 10
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видео. Частые значения: 16:9, 9:16, 1:1
​
reference_images
string[]
Обычные референсные изображения.
  • Это только референсы
  • Вторая картинка больше не интерпретируется автоматически как последний кадр
  • Для управления кадрами используйте image_with_roles
​
image_with_roles
object[]
Явный массив изображений с ролями для управления кадрами или смешанного ввода.
Последний кадр отправляется только если last_frame явно указан в image_with_roles. Система больше не выводит его из reference_images[1].
​
negative_prompt
string
Негативный промпт для исключения нежелательного контента.
​
audio
boolean
по умолчанию:"false"
Автоматически генерировать аудио.
Доступно только в mode: "pro".
​
watermark
boolean
Добавить водяной знак.

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

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

​
Примеры

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

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

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

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

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

{
  "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
}

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

{
  "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
}

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

{
  "model": "kling-v2-6",
  "prompt": "Волны разбиваются о скалы, чайки кружат в небе, вдали маяк",
  "mode": "pro",
  "duration": 10,
  "audio": true,
  "aspect_ratio": "16:9"
}
Генерация видео является асинхронной задачей. Используйте эндпоинт статуса видео-задачи для запроса прогресса и результата.