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-pro/text-to-video",
  "input": {
    "duration": 3,
    "multi_shots": false,
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "sound": true
  }
}
'

{
  "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 3.0 Pro Text to Video

Direct video sequences with Kling 3.0 Pro, using individual shot prompts, shot timing, and optional sound to shape a scene.

​

Available Models

• kwaivgi/kling-v3.0-pro/text-to-video - Generate video scenes from text prompts.

​

Duration Options

• 3-15 seconds - Set duration as an integer. Required.
• With multi_prompt, the shot durations must add up to the requested duration.

​

Key Features

• Generate video scenes from text prompts.
• Describe individual shots with multi_prompt and enable multi_shots.

​

Advanced Parameters

Set model 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_prompt shot requires a nonblank prompt and an integer duration from 1 to 12 seconds.
• The shot durations must sum to the requested duration. Set multi_shots: true and sound: true when using multi_prompt.

​

Prompt

• prompt: Required when multi_shots is false. Describe the scene and desired motion. Length: 1-2,500 characters.
• Use nonblank text for each prompt.

​

Multi-Prompt

• multi_prompt: Required when multi_shots is true. 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 from 1 to 12.
• Each shot duration is measured in seconds.

​

Multi-Shot Generation

• multi_shots: Optional. Enable multi-shot generation. Use true or false. Default: false.

​

Sound

• sound: Optional. Set true to generate audio or false for a silent single shot. Multiple shots require true. Default: true.

​

Aspect Ratio

• aspect_ratio: Optional. Accepted values: 1:1, 16:9, 9:16. Default: 1:1.