GET

/v1/schemas/kling/video/v1/videos/image2video

Accept:

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

field	recorded source
schema	Source linked above. docs-derived Source trace `909c71aea16848604ee3f0eea849aa72404db67ff4814a654942f4f6f085ed30` { "fetchedAt": 1786771298, "extractorVersion": "1", "verifiedAt": null }

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

Types

4 $defs

CameraConfigobject

Fine-grained camera motion when camera_control.type is `simple`. Official docs allow only one non-zero axis per request. Each axis is in [-10, 10].

horizontal	number	-10 ≤ n ≤ 10
vertical	number	-10 ≤ n ≤ 10
pan	number	-10 ≤ n ≤ 10
tilt	number	-10 ≤ n ≤ 10
roll	number	-10 ≤ n ≤ 10
zoom	number	-10 ≤ n ≤ 10

CameraControlobject

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.

type	enum		simple \| down_back \| forward_up \| right_turn_forward \| left_turn_forward
config	CameraConfig	Fine-grained camera motion when camera_control.type is `simple`. Official docs allow only one non-zero axis per request. Each axis is in [-10, 10].

DynamicMaskobject

mask*	string	Brush mask as a raw base64 image or https URL.
trajectories*	object[]	Motion path; 2–77 {x,y} points for a 5s clip.	items ≥ 2

VoiceRefobject

voice_id*

string

Voice id referenced from the prompt as <<<voice_1>>> …

Validate a payload

before you spend tokens

shell

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