curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-4.0-flash",
"prompt": "Волны у берега, плавное приближение камеры, закатный свет",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
{
"id": "task_example",
"object": "generation.task",
"model": "kling-4.0-flash",
"status": "queued",
"created_at": 1792713600
}
Kling v4 Flash
Генерация видео Kling v4 Flash
Единая модель kling-4.0-flash для текста, референсов и генерации по начальному кадру
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-4.0-flash",
"prompt": "Волны у берега, плавное приближение камеры, закатный свет",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
{
"id": "task_example",
"object": "generation.task",
"model": "kling-4.0-flash",
"status": "queued",
"created_at": 1792713600
}
Все три режима используют
По умолчанию 5 секунд / 720p. Явно задавайте параметры для контроля результата. Фиксированные цены и соответствие сохранения звука старому тарифу Sound не обещаются. Оплата определяется котировкой аккаунта и полями usage / billing задачи.
kling-4.0-flash. Путь генерации выбирается по переданным материалам. API асинхронный; после отправки запрашивайте результат по ID задачи платформы.
Используйте API-ключ платформы. В материковом Китае можно заменить
https://toapis.com на https://toapis.cn. Доступность зависит от развернутой конфигурации канала и прав аккаунта.Режимы ввода
| Режим | Содержимое запроса |
|---|---|
| Текст в видео | Передайте текст и параметры результата без медиа. |
| Референсы | Используйте image_urls / video_urls или материалы с reference-ролями. Изображения и видео можно сочетать. |
| Начальный кадр | Задайте одно изображение first_frame в image_with_roles. Не добавляйте референсные изображения или видео; промежуточные и конечные кадры не поддерживаются. |
Параметры запроса
string
обязательно
Авторизация:
Bearer YOUR_API_KEY.string
обязательно
Всегда
kling-4.0-flash. Не меняйте ID модели при переключении режима.string
обязательно
Обязательный непустой текст, до 8000 символов Unicode. Опишите субъект, движение, камеру и связь между материалами.
integer
по умолчанию:"5"
Целое число от 3 до 20 секунд. По умолчанию 5.
string
по умолчанию:"720p"
Только
720p. По умолчанию 720p.string
auto, 16:9, 9:16, 1:1, 21:9. При отсутствии сохраняется значение провайдера; для автоматического соотношения можно явно передать auto.string[]
Массив URL референсных изображений, до 10. Позиция не означает начальный кадр. Количество суммируется с reference-ролями; не дублируйте материалы.
string[]
Массив URL референсных видео, до 5 вместе с
video_with_roles.object[]
Поля объекта:
url и role. reference / reference_image обозначают референс, first_frame обозначает начальный кадр. keyframe и last_frame не поддерживаются.object[]
Поля объекта:
url и role. Поддерживаются reference / reference_video.object
Логическое поле
keep_original_sound сохраняет звук референсного видео, например {"keep_original_sound": true}. Только для референсного видео. В режиме начального кадра запрещено даже значение false.string
Необязательный бизнес-ID клиента, сохраняется в задаче и поддерживается тем же API статуса.
Правила материалов и валидация
- Используйте общедоступные HTTP(S) URL без имени пользователя и пароля. Локальные файлы сначала загрузите через загрузку изображений или видео. Не передавайте локальные пути или base64.
- Режим референсов допускает до 10 изображений и 5 видео. Обычные массивы и явные reference-роли суммируются; не отправляйте один материал дважды.
- Режим начального кадра принимает ровно одно изображение
first_frame; ролиkeyframeиlast_frameотклоняются. Начальный кадр определяется ролью, а не позицией обычного изображения. - Начальный кадр несовместим с референсами. Не используйте старые Kling
mode,audio,video_listи структуры Omni.audio_with_roles,metadata.elements,metadata.voicesне поддерживаются. - Недопустимые параметры, роли, URL, количества и сочетания режимов отклоняются. Исправьте ошибку перед повторной отправкой. Страница не гарантирует пределы размера, кодеков или длины входного видео; учитывайте требования загрузки и провайдера.
Примеры запросов
Текст в видео
{
"model": "kling-4.0-flash",
"prompt": "Волны у берега, плавное приближение камеры, закатный свет",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}
Референсы
{
"model": "kling-4.0-flash",
"prompt": "Сохранить персонажа с изображения и движение камеры из референсного видео",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_urls": [
"https://example.com/character.png"
],
"video_urls": [
"https://example.com/motion.mp4"
],
"metadata": {
"keep_original_sound": true
}
}
Начальный кадр
{
"model": "kling-4.0-flash",
"prompt": "Начиная с первого кадра, персонаж медленно поворачивается к окну",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_with_roles": [
{
"url": "https://example.com/first.png",
"role": "first_frame"
}
]
}
Отправка задачи
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-4.0-flash",
"prompt": "Волны у берега, плавное приближение камеры, закатный свет",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
{
"id": "task_example",
"object": "generation.task",
"model": "kling-4.0-flash",
"status": "queued",
"created_at": 1792713600
}
Статус задачи и оплата
Полеid ответа является ID задачи платформы. Используйте API ниже вместо task_id провайдера. Статусы: queued, in_progress, completed, failed. См. статус видео и Webhook задач.
curl --request GET \
--url https://toapis.com/v1/videos/generations/YOUR_TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY'