Kling 4.0 Image to Video

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kwaivgi/kling-v4.0/image-to-video",
  "input": {
    "image_urls": [
      "https://example.com/dancer.png"
    ],
    "prompt": "The dancer spins and her red dress flares out, the camera slowly circles her, soft piano music",
    "duration": 5,
    "resolution": "720p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

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-v4.0/image-to-video",
  "input": {
    "image_urls": [
      "https://example.com/dancer.png"
    ],
    "prompt": "The dancer spins and her red dress flares out, the camera slowly circles her, soft piano music",
    "duration": 5,
    "resolution": "720p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30: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_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.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Kling 4.0 Image to Video animates a start frame into a 3–30 second video at 720p or 1080p. Add a second image and Kling 4.0 uses it as the end frame, generating the motion between the two. It suits product shots, character animation and before/after transitions. Kling 4.0 is Kuaishou’s Kling AI video model. Vidgo exposes it as four model IDs: Text to Video, Image to Video, Reference to Video and Video Edit.

Models

kwaivgi/kling-v4.0/image-to-video — Image-to-video with Kling 4.0 from a start frame and an optional end frame.

Features

Image-to-video up to 30 seconds from one start frame.
First and last frame control with a second image.
Single or multi-shot prompts.
720p or 1080p output; the frame shape follows the input image.
Output includes an audio track.

Input modes

Start frame: image_urls with one image.
Start and end frame: image_urls with two images, start frame first.

Either mode takes a single prompt or a multi_prompt shot list:

Single prompt: send prompt and, optionally, duration.
Multi-shot: send multi_prompt with one entry per shot. The clip length is the sum of the shot durations; leave duration out or set it to that sum.

Required parameters

image_urls (string[]): One or two public HTTP(S) image URLs. The first is the start frame; the optional second is the end frame.
prompt (string) or multi_prompt (object[]): send exactly one.
- prompt: 1–26,000 characters after trimming.
- multi_prompt: a non-empty list of shots {prompt, duration?}. Each shot prompt is 1–512 characters; each shot duration is an integer 1–30 (default 5). The shot durations must total 3–30 seconds.

Optional parameters

duration (integer): Output length, 3–30 seconds. Default 5; with multi_prompt the default is the shot total, and an explicit value must equal it.
resolution (string): 720p or 1080p. Default 720p.

Output

The finished task returns one MP4 video, with an audio track, in the files array of Query Task Status and the callback payload.

Examples

Start frame only: one image of a dancer with a motion and music prompt, 5 seconds at 720p.
Start and end frame, 1080p, with callback: a bud and an open flower as start and end frames, an 8-second time-lapse and a callback_url.

Notes

aspect_ratio is not supported on this ID because the input image sets the frame; sending it returns 400.
To guide the video with extra reference images, reference videos or subjects, use Kling 4.0 Reference to Video.
Fields not listed above return 400. model and callback_url belong at the request root, not inside input.
Credits are reserved at submission and depend on resolution and the output duration. A failed task is refunded in full. See the pricing page for current rates.
Output is 720p or 1080p only; there is no 4K or HDR tier, no audio on/off switch and no seed on this model.

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication

Get your API Key:

Go to Dashboard → API Key (API Key Management Page) to get your API Key

Add it to the request header:

Authorization: Bearer VIDGO_API_KEY

Body

application/json

model

string

required

Model ID. Use kwaivgi/kling-v4.0/image-to-video.

Example:

"kwaivgi/kling-v4.0/image-to-video"

input

object

required

Generation parameters.

Show child attributes

callback_url

string<uri> | null

Optional public HTTP(S) endpoint that receives a POST when the task becomes finished or failed. HTTPS is recommended. Omit it, or send null or an empty string, to disable callbacks.

Example:

"https://your-domain.com/callback"

Response

Task submitted

code

enum<integer>

required

HTTP status code.

Available options:

200

data

object

required

Show child attributes

​Models

​Features

​Input modes

​Required parameters

​Optional parameters

​Output

​Examples

​Notes

Authorizations

Body

Response

Models

Features

Input modes

Required parameters

Optional parameters

Output

Examples

Notes