Kling Video 3 Pro
model-kling-video-v3-proPOST/v1/generationsОриентирот 115 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#start_image_urlfile · inputAssetsнеобязательныйИсходное изображение — Необязательно: добавьте стартовый кадр, чтобы включить режим изображения в видео.
- По умолчанию
- нет
- Ограничения
- форматы: image/* · сценарии: scenario-0
promptstringобязательныйЧто должно произойти? — Опишите движение, сцену, камеру и желаемое настроение.
- По умолчанию
- нет
- Ограничения
- до 2500 символов
durationstring (enum)обязательныйДлительность, секунд — От 3 до 15 секунд. Длительность влияет на стоимость.
- По умолчанию
"5"
Допустимые значения
33 сек.44 сек.55 сек.66 сек.77 сек.88 сек.99 сек.1010 сек.1111 сек.1212 сек.1313 сек.1414 сек.1515 сек.
generate_audiobooleanнеобязательныйСоздать звук — Добавляет подходящие звуки и атмосферу; влияет на стоимость.
- По умолчанию
true
negative_promptstringнеобязательный· расширенныйЧего избегать — Необязательно: артефакты, нежелательные объекты или движения.
- По умолчанию
- нет
- Ограничения
- до 2500 символов
cfg_scalenumberнеобязательный· расширенныйТочность следования запросу — Обычно достаточно значения 0.5.
- По умолчанию
0.5- Ограничения
- 0–1 · шаг 0.1
shot_typestring (enum)необязательный· расширенныйРабота камеры
- По умолчанию
"intelligent"
Допустимые значения
intelligentАвтоматическиcustomizeПо описанию
end_image_urlfile · inputAssetsнеобязательный· расширенныйФинальный кадр — Необязательно: изображение, к которому должно прийти видео.
- По умолчанию
- нет
- Ограничения
- форматы: image/* · требует start_image_url · сценарии: scenario-0
aspect_ratiostring (enum)необязательныйФормат кадра
- По умолчанию
"16:9"- Ограничения
- сценарии: scenario-1
Допустимые значения
16:916:9 · горизонтальный9:169:16 · вертикальный1:11:1 · квадрат
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0передан файл start_image_url
Активные поля: start_image_url, prompt, duration, generate_audio, negative_prompt, cfg_scale, shot_type, end_image_url
{
"model": "model-kling-video-v3-pro",
"values": {
"prompt": "Describe the desired result",
"duration": "5",
"generate_audio": true,
"cfg_scale": 0.5,
"shot_type": "intelligent"
},
"inputAssets": [
{
"fieldName": "start_image_url",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}scenario-1по умолчанию
Активные поля: prompt, duration, generate_audio, negative_prompt, cfg_scale, shot_type, aspect_ratio
{
"model": "model-kling-video-v3-pro",
"values": {
"prompt": "Describe the desired result",
"duration": "5",
"generate_audio": true,
"cfg_scale": 0.5,
"shot_type": "intelligent",
"aspect_ratio": "16:9"
},
"inputAssets": []
}Цена и результат
#Ориентир при стандартных настройках — 115 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.
Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.
Машиночитаемая схема: GET /v1/generation-models/model-kling-video-v3-pro. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.