curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-v3.0-4k/text-to-video",
"input": {
"duration": 3,
"multi_shots": false,
"prompt": "A quiet forest under soft morning light, with natural detail.",
"sound": false
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Kling
Kling 3.0 4K Text to Video
Direct video sequences with Kling 3.0 4K, using individual shot prompts, shot timing, and optional sound to shape a scene.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-v3.0-4k/text-to-video",
"input": {
"duration": 3,
"multi_shots": false,
"prompt": "A quiet forest under soft morning light, with natural detail.",
"sound": false
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Models
- kwaivgi/kling-v3.0-4k/text-to-video - Generate video scenes from text prompts.
Features
- Generate video scenes from text prompts.
- Describe individual shots with
multi_promptand enablemulti_shots.
Duration Options
- 3-15 seconds - Set
durationas an integer. Required. - With
multi_prompt, the shot durations must add up to the requestedduration.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.
Use the input fields listed below. Send durations as JSON integers and switches as JSON booleans.
- Each
multi_promptshot requires a nonblankpromptand an integerdurationfrom 1 to 12 seconds. - The shot durations must sum to the requested
duration. Setmulti_shots: trueandsound: truewhen usingmulti_prompt.
Prompt
prompt: Required whenmulti_shotsisfalse. Describe the scene and desired motion. Length: 1-2,500 characters.- Use nonblank text for each prompt.
Multi-Prompt
-
multi_prompt: Required whenmulti_shotsistrue. Supply a nonempty array. Each item is an object. -
multi_prompt[].prompt: Required. Maximum length: 2,500 characters. -
multi_prompt[].duration: Required. Duration in seconds. Integer from1to12. - Each shot duration is measured in seconds.
Multi-Shot Generation
multi_shots: Optional. Enable multi-shot generation. Usetrueorfalse. Default:false.
Sound
sound: Required. Settrueto generate audio orfalsefor a silent single shot. Multiple shots requiretrue.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Place model and callback_url at the request root, and generation parameters inside input.
Example:
"kwaivgi/kling-v3.0-4k/text-to-video"
Input parameters for generation
- Option 1
- Option 2
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.