Kling Text-to-Video kling-v3
Submit a Kling text-to-video task via /kling/v1/videos/text2video. The request body is forwarded to the Kling official API after model mapping and public task ID injection.
Authorizations
Pass Authorization: Bearer <token> in the request header.
Headers
Data exchange format
Body
Model name
kling-v3 Positive text prompt
- Must not exceed 2500 characters
- Use <<<voice_1>>> to specify a voice, index matching voice_list; up to 2 voices; sound must be 'on' when specifying voices; keep syntax simple, e.g.: A man<<<voice_1>>>says: "Hello"
- When voice_list is not empty and prompt references a voice ID, billing is based on 'with specified voice'
- Must not be empty when multi_shot is false or shot_type is intelligence.
2500Whether to generate a multi-shot video. When this parameter is true, the prompt parameter is invalid and first/last frame video generation is not supported. When this parameter is false, the shot_type and multi_prompt parameters are invalid.
Shot type Required when multi_shot is true.
customize, intelligence Multi-shot information including prompt, duration, etc. Define shot index and corresponding prompt and duration via index, prompt, duration parameters.
- Max 6 shots, min 1 shot.
- Max length per shot content: 512 characters.
- Each shot duration must not exceed total task duration and must be >= 1.
- Sum of all shot durations must equal total task duration.
Use key:value format:
Required when multi_shot is true and shot_type is customize.
1 - 6 elementsNegative text prompt
- Must not exceed 2500 characters
- It is recommended to supplement negative prompt information through negative sentences in the positive prompt
2500Whether to also generate audio when creating the video
on, off Creative freedom of video generation; higher values result in less model freedom
0 <= x <= 1Video generation mode
- std: Standard mode, cost-effective, output video resolution 720P.
- pro: Expert mode (high quality), better video quality, output video resolution 1080P.
- 4k: 4K mode, high quality (same as pro), better video quality, output video resolution 4K.
std, pro, 4k Aspect ratio of generated video frames (width:height)
1:1, 16:9, 9:16 Video duration in seconds.
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Whether to also generate a watermarked result.
- Defined via the enabled parameter:
- true to generate, false to not generate
- Custom watermarks are not currently supported
Callback notification URL for this task. If configured, the server will proactively notify when the task status changes.
Custom task ID.
- Does not override the system-generated task ID, but supports querying by this ID.
- Must be unique per user.