curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-video/v1.6/standard/image-to-video",
"input": {
"prompt": "A quiet forest in morning light, with a slow camera pan.",
"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
Kling 1.6 Standard Image to Video
Kling 1.6 Standard Image to Video parameters and billing factors.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-video/v1.6/standard/image-to-video",
"input": {
"prompt": "A quiet forest in morning light, with a slow camera pan.",
"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>"
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
kwaivgi/kling-video/v1.6/standard/image-to-video.
Input modes
Provide eitherstart_image_url for first-frame animation or image_urls for Elements. The endpoint does not accept text-only requests.
- Elements accepts 1–4 reference images and cannot be combined with
start_image_urlorcfg_scale. - Standard first-frame animation does not support
aspect_ratio; Elements does.
Parameters
Place generation parameters insideinput. Keep model and optional callback_url at the request root. Unsupported input fields are rejected before credits are deducted.
| Parameter | Requirement | Description |
|---|---|---|
prompt | Required | Required nonblank string, at most 2,500 Unicode characters after trimming. |
duration | Required | Required integer: 5 or 10 seconds. No API default. |
aspect_ratio | Optional | Optional: 1:1, 16:9 or 9:16. No API default. Not supported in Standard first-frame image-to-video; supported in Elements. |
negative_prompt | Optional | Optional string, at most 2,500 Unicode characters. |
cfg_scale | Optional | Optional finite number from 0 to 1. Not supported with image_urls. No API default. |
start_image_url | Conditional | First-frame HTTP(S) URL. Required for the first-frame workflow; mutually exclusive with image_urls. |
image_urls | Conditional | Elements: 1 to 4 HTTP(S) reference URLs. Mutually exclusive with start_image_url and cfg_scale. |
Billing Factors
Billing depends on the selected model tier (Standard or Pro) and video duration (duration). Usage is charged per generated second. Within a tier, text-to-video, first-frame animation, and Elements use the same rate.
Credits are deducted on submission and refunded if the task fails.Authorizations
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.
Example:
"kwaivgi/kling-video/v1.6/standard/image-to-video"
Input parameters for generation.
Choose either the first-frame workflow with start_image_url, or the Elements workflow with image_urls. Do not combine image_urls with first-frame controls.
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.