GET

/v1/schemas/kling/video/v1%2Fvideos%2Ftext2video

kind inputactivity videohash 75d62cfe…extracted Aug 15, 2026version currentsource upstream spec ↗

Request body

14 properties · 1 required · 3 $defs
propertytypedescriptionconstraints
prompt*stringPositive scene prompt.length ≤ 2500
model_namestringVideo model id. Documented values include kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-v2-6, kling-v3. Default kling-v1.
negative_promptstringlength ≤ 2500
soundenumNative audio. v2.6+ (typically requires mode=pro). Default off.on | off
cfg_scalenumberPrompt adherence. Default 0.5. Not supported on v2.x.0 ≤ n ≤ 1
modeenumQuality tier. Default std.std | pro
aspect_ratioenumDefault 16:9.16:9 | 9:16 | 1:1
durationstringClip length in seconds, sent as a string. Classic models: 5 or 10. Newer 3.0 models accept 3–15.
camera_controlCameraControlCamera movement. Presets: simple, down_back, forward_up, right_turn_forward, left_turn_forward. Supported on older models (kling-v1 / v1.5 / v1.6), not v2.x.
multi_shotbooleanSplit the clip into storyboard shots (v3.0+).
shot_typeenumRequired when multi_shot is true.customize | intelligence
multi_promptMultiPromptShot[]Per-shot prompts when shot_type=customize. Durations must sum to duration.
callback_urlstringWebhook for task status changes.format: uri
external_task_idstringCaller-chosen id; must be unique per account.

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"kling","endpointId":"v1/videos/text2video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}