Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
Генерация видео Kling v3
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>"
    }
  ],
  "audio": true,
  "metadata": {
    "negative_prompt": "<string>",
    "watermark": true
  }
}
'
  • Асинхронный API задач, после отправки возвращает ID задачи
  • Поддерживает текст-в-видео, изображение-в-видео, явное управление первым/последним кадром и видео со звуком
  • mode=std соответствует 720P, mode=pro соответствует 1080P
  • audio=true включает генерацию звука и тарифицируется как Sound
  • Текст-в-видео поддерживает 15 секунд; запросы с изображениями поддерживают до 10 секунд
Используйте публично доступные URL изображений. Не передавайте base64-данные напрямую; сначала загрузите изображение через API загрузки изображений.

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

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

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

​
model
string
обязательно
Название модели генерации видео, фиксированное значение kling-v3.
​
prompt
string
обязательно
Текстовый промпт. Опишите объект, действие, сцену, движение камеры и стиль.
​
mode
string
по умолчанию:"std"
Режим генерации.
  • std - стандартный режим, 720P
  • pro - профессиональный режим, 1080P
​
duration
integer
по умолчанию:"5"
Длительность видео в секундах.Варианты: 5, 10, 15
15 секунд поддерживается только для текст-в-видео. Запросы с входными изображениями поддерживают максимум 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].
​
audio
boolean
по умолчанию:"false"
Генерировать ли видео со звуком.
​
metadata
object
Дополнительные параметры.

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

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

​
Примеры

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

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

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

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

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

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

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

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

​
Видео со звуком

{
  "model": "kling-v3",
  "prompt": "Певец выступает на сцене, толпа аплодирует, мигают огни",
  "mode": "std",
  "duration": 5,
  "audio": true
}
Генерация видео асинхронная. Используйте эндпоинт статуса видео-задачи для запроса прогресса и результата.