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/image-to-video",
  "input": {
    "duration": 3,
    "prompt": "A gentle camera push brings the scene to life.",
    "image_urls": [
      "https://example.com/image.png"
    ],
    "multi_shots": false,
    "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 Image to Video

Animate image references with Kling 3.0 Pro, with support for multiple shots, individual shot prompts, and optional sound.

​

Available Models

• kwaivgi/kling-v3.0-pro/image-to-video - Generate video from image input.

​

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 from image input.
• Provide 1–2 images in image_urls.
• Describe individual shots with multi_prompt and enable multi_shots.
• Supply additional subject references through kling_elements.

​

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. Use public HTTP(S) media URLs with a hostname and URL-based access.

• 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.
• When supplying kling_elements, provide image_urls and reference the element by @element_name in the prompt.

​

Image URLs

• image_urls: Required. Provide publicly accessible image URLs. Supply 1–2 items: the start frame first, followed by an optional end frame. For multiple shots, provide one start frame. Each item must be an HTTP(S) URL.

​

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.

​

Kling Elements

• kling_elements: Optional. Provide element-reference objects. Supply an array. Each item is an object.
• kling_elements[].name: Required. Nonblank element name used in @element_name references.
• kling_elements[].description: Optional. String.
• kling_elements[].element_input_urls: Provide 2–4 JPG/PNG image URLs, up to 10 MB per image, when defining the element with images.
• kling_elements[].element_input_video_urls: Provide one MP4/MOV video URL, up to 50 MB, when defining the element with video. Choose one media type per element.

​

Aspect Ratio

• aspect_ratio: Optional. Accepted values: 1:1, 16:9, 9:16. The first frame determines the output aspect ratio.