Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
Generate video with Kling 2.5 Turbo Pro using a start frame, an end frame, or both, plus a text prompt.

Models

  • kwaivgi/kling-v2.5-turbo-pro/image-to-video - Generate video from image input.

Features

  • Generate video from image input.
  • Guide generation with start_image_url, end_image_url, or both.

Duration Options

  • 5, 10 seconds - Set duration as an integer. Optional. Default: 5 seconds. Strings, booleans, fractional durations, and null are rejected.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials or whitespace. Image fields do not accept arrays or Base64.

Prompt

  • prompt: Required. Describe the scene and desired motion. Length: 1-2,500 characters.
  • Supply a string, not a number, boolean, array, or object. Whitespace is trimmed before the 2,500 Unicode character limit is checked.

Start Image URL

  • start_image_url: First-frame public HTTP(S) URL. Required only when end_image_url is omitted.

End Image URL

  • end_image_url: Last-frame public HTTP(S) URL. Required only when start_image_url is omitted.
  • Provide at least one frame: start only, end only, or both. Omit unused URL fields; empty strings and null are rejected.

Aspect Ratio

  • aspect_ratio: Optional string. No preset choices or default value are specified. Omit when unused.

Negative Prompt

  • negative_prompt: Optional. Describe content to avoid.

Billing Factors

Billing depends on video duration (duration). Text-to-video and image-to-video use the same rates. Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.

model
string
required
Example:

"kwaivgi/kling-v2.5-turbo-pro/image-to-video"

input
object
required

Provide at least one of start_image_url, end_image_url.

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