GET
/v1/schemas/kling/video/v1%2Fvideos%2Fimage2video
Accept:
Request body
16 properties · 0 required · 4 $defs| property | type | description | constraints |
|---|---|---|---|
| model_name | string | Video model id. Documented values include kling-v1, kling-v1-5, kling-v1-6, kling-v2-master, kling-v2-1, kling-v2-1-master, kling-v2-5-turbo, kling-v2-6, kling-v3. | |
| image | string | Start frame: https URL or raw base64 (no data: URI prefix). jpg/png, ≤10MB, ≥300px, aspect 1:2.5–2.5:1. | |
| image_tail | string | End frame (same encoding). Usually requires mode=pro. | |
| prompt | string | length ≤ 2500 | |
| negative_prompt | string | length ≤ 2500 | |
| voice_list | VoiceRef[] | Voice references (v2.6+). Reference via <<<voice_1>>> in prompt. | items ≤ 2 |
| sound | enum | on | off | |
| cfg_scale | number | 0 ≤ n ≤ 1 | |
| mode | enum | std | pro | |
| static_mask | string | Static brush mask (base64 or URL). | |
| dynamic_masks | DynamicMask[] | items ≤ 6 | |
| camera_control | CameraControl | Camera 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. | |
| aspect_ratio | enum | 16:9 | 9:16 | 1:1 | |
| duration | string | Clip length in seconds as a string (5 or 10; 3–15 on 3.0). | |
| callback_url | string | format: uri | |
| external_task_id | string |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"kling","endpointId":"v1/videos/image2video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}