Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
Генерация видео kling-v3-fast
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "reference_images": [
    "<string>"
  ],
  "resolution": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "watermark": true
}
'
  • Асинхронный API задач, после отправки возвращает ID задачи
  • Использует новый официальный протокол Kling Turbo
  • Поддерживает текст-в-видео и изображение-в-видео, но только с первым кадром
  • resolution поддерживает 720p и 1080p
  • duration поддерживает 3s, 4s, 5s, 6s, 7s, 8s, 9s, 10s, 11s, 12s, 13s, 14s, 15s
  • aspect_ratio применяется только к запросам текст-в-видео
  • watermark поддерживается только как булев переключатель без кастомного объекта
Используйте публично доступные URL изображений. Не передавайте base64-данные напрямую; сначала загрузите изображение через API загрузки изображений.

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

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

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

​
model
string
обязательно
Название модели генерации видео, фиксированное значение kling-v3-fast.
​
prompt
string
обязательно
Текстовый промпт. Для image-to-video это значение будет отправлено в Kling Turbo как элемент prompt внутри contents.
​
reference_images
string[]
Необязательные входные изображения. Для Kling Turbo image-to-video используется только первое изображение как first_frame.
Последний кадр в этой интеграции не поддерживается. Дополнительные изображения не отправляются как tail frame.
​
resolution
string
по умолчанию:"720p"
Разрешение видео.Поддерживаемые значения:
  • 720p
  • 1080p
​
duration
integer
по умолчанию:"5"
Длительность видео в секундах.Поддерживаемые значения: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон для текст-в-видео.Поддерживаемые значения:
  • 16:9
  • 9:16
  • 1:1
​
watermark
boolean
по умолчанию:"false"
Добавлять ли официальный водяной знак Kling.

​
Примеры

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

{
  "model": "kling-v3-fast",
  "prompt": "A cinematic shot of a red sports car driving through rain",
  "resolution": "720p",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Изображение-в-видео

{
  "model": "kling-v3-fast",
  "prompt": "Animate the character with subtle camera motion",
  "reference_images": ["https://example.com/first-frame.png"],
  "resolution": "1080p",
  "duration": 5,
  "watermark": true
}
Генерация видео асинхронная. Используйте эндпоинт статуса видео-задачи для запроса прогресса и результата.