curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kwaivgi/kling-v2.5-turbo-pro/image-to-video",
  "input": {
    "prompt": "A slow camera pan across a sunlit garden.",
    "duration": 5,
    "start_image_url": "https://example.com/start-frame.png"
  }
}
'

{
  "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 2.5 Turbo Pro Image to Video

Generate video with Kling 2.5 Turbo Pro using a start frame, an end frame, or both, plus a text prompt.

​

Available Models

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

​

Duration Options

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

​

Key Features

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

​

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. PoYo does not document an enum or default. 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.