Skip to main content
POST
  1. Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
  2. Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Kling 3.0 Standard Text to Video

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

Available Models

  • kwaivgi/kling-v3.0-std/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.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Place model and callback_url at the request root, and generation parameters inside input.

model
string
required
Example:

"kwaivgi/kling-v3.0-std/text-to-video"

input
object
required

Input parameters for generation

callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required