GET

/v1/schemas/kling/video/v1/videos/text2video

Accept:

kind inputactivity videohash 75d62cfe…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

14 properties · 1 required · 3 $defs

property	type	description	constraints
prompt*	string	Positive scene prompt.	length ≤ 2500
model_name	string	Video 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_prompt	string		length ≤ 2500
sound	enum	Native audio. v2.6+ (typically requires mode=pro). Default off.	on \| off
cfg_scale	number	Prompt adherence. Default 0.5. Not supported on v2.x.	0 ≤ n ≤ 1
mode	enum	Quality tier. Default std.	std \| pro
aspect_ratio	enum	Default 16:9.	16:9 \| 9:16 \| 1:1
duration	string	Clip length in seconds, sent as a string. Classic models: 5 or 10. Newer 3.0 models accept 3–15.
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.
multi_shot	boolean	Split the clip into storyboard shots (v3.0+).
shot_type	enum	Required when multi_shot is true.	customize \| intelligence
multi_prompt	MultiPromptShot[]	Per-shot prompts when shot_type=customize. Durations must sum to duration.
callback_url	string	Webhook for task status changes.	format: uri
external_task_id	string	Caller-chosen id; must be unique per account.

Types

3 $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].

MultiPromptShotobject

index*	integer		n ≥ 1
prompt*	string		length ≤ 512
duration*	string	Shot length in seconds.

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", …}]}