Kling 4.0 Image to Video API

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

720p / 1080p · 3–30 sec

Kling 4.0 Image to Video animates a start image into a 3–30 second 720p or 1080p video with stereo audio, optionally finishing on an end frame you choose. It keeps the subject, framing and look of your image while adding the motion, camera work and sound in your prompt.

Input

Prompt373/26000

Image Urls

Drag and drop files, paste from clipboard, or provide a URL. Required. 1–2 JPEG, PNG or WebP images: start frame, then optional end frame.

2/2 files added

Duration

Resolution

Switch to JSON to write multi-shot prompts with multi_prompt.

OutputExample

Continue with

Kling 4.0 Text to Video Kling 4.0 Reference to Video Kling 4.0 Video Edit Kling 3.0 Turbo Pro Image to Video

REST API

Quick Start

Make your first Kling 4.0 Image to Video request in three steps. The example sends a start and end frame for a 6-second clip and returns a task_id.

Connect to the Vidgo API

Create an API key, keep it on your server, and send it in the Authorization header as a Bearer token.

Endpoint: POSThttps://api.vidgo.ai/api/generate/submit
Authentication: Authorization: Bearer VIDGO_API_KEY

Submit one generation task

Run the short example with a prompt and at least one image in image_urls.

Submit request

curl --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "kwaivgi/kling-v4.0/image-to-video",
  "input": {
    "prompt": "The climber from the first image reaches up, finds a hold, and pulls herself onto the ledge shown in the second image. Chalk dust drifts from her hand, the rope sways gently below. Camera holds a steady side angle with a slight upward tilt. Late-afternoon sun on sandstone. Audio: wind across the rock face, a short exhale, carabiner clink. No text, no logos, no watermark.",
    "duration": 6,
    "resolution": "720p",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/kwaivgi/kling-v4.0/image-to-video/v1/01/input-start-frame.webp",
      "https://cdn.vidgo.ai/apis/models/kwaivgi/kling-v4.0/image-to-video/v1/01/input-end-frame.webp"
    ]
  }
}'

Wait for the result

Use the returned task_id to check the same task until it reaches finished or failed. On success, read data.files[].file_url.

Track status

GET https://api.vidgo.ai/api/generate/status/{task_id}

Poll every few seconds while the status is not_started or running, and stop on finished or failed. On success, read data.files[].file_url. For longer clips, lengthen the interval gradually or add callback_url to the submit request.

not_startedrunningfinishedfailed

Submit response

{
  "code": 200,
  "data": {
    "task_id": "JWDB8PZQOCAI2DMO",
    "status": "not_started",
    "created_time": "2026-11-05T07:05:15"
  }
}

Finished response

{
  "code": 200,
  "data": {
    "task_id": "JWDB8PZQOCAI2DMO",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/kwaivgi/kling-v4.0/image-to-video/v2/01/output-01.mp4",
        "file_type": "video"
      }
    ],
    "created_time": "2026-11-05T07:05:15",
    "error_message": null,
    "progress": 100
  }
}

Complete runnable example

Open this after the three-step flow is clear. It combines submission, polling, terminal-state handling and result extraction in one script.

Complete runnable example

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "kwaivgi/kling-v4.0/image-to-video",
  "input": {
    "prompt": "The climber from the first image reaches up, finds a hold, and pulls herself onto the ledge shown in the second image. Chalk dust drifts from her hand, the rope sways gently below. Camera holds a steady side angle with a slight upward tilt. Late-afternoon sun on sandstone. Audio: wind across the rock face, a short exhale, carabiner clink. No text, no logos, no watermark.",
    "duration": 6,
    "resolution": "720p",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/kwaivgi/kling-v4.0/image-to-video/v1/01/input-start-frame.webp",
      "https://cdn.vidgo.ai/apis/models/kwaivgi/kling-v4.0/image-to-video/v1/01/input-end-frame.webp"
    ]
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

while true; do
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep 2
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done

Request Parameters

model and callback_url belong at the request root; generation parameters belong inside input.

Field	Type	Required	Default	Description
model	string	Yes	—	Fixed to kwaivgi/kling-v4.0/image-to-video.
callback_url	string (URL)	No	—	A public HTTP(S) URL that receives the task result when it finishes.
input	object	Yes	—	Generation parameters: 1–2 images and prompt or multi_prompt, plus optional duration and resolution.
input.prompt	string	No	—	Single prompt, 1–26,000 characters. Exactly one of prompt or multi_prompt.
input.multi_prompt	object[]	No	—	Shots of {prompt, duration?}; totals 3–30 s. If duration is also sent it must equal the total.
input.image_urls	string[]	Yes	—	1–2 URLs: [start_frame] or [start_frame, end_frame].
input.duration	integer	No	5	3–30 s.
input.resolution	string	No	720p	720p or 1080p.

Response Fields

Submission returns the task identity immediately. Status responses add progress, output files or a failure message as the task advances.

Field	Type	Description
code	integer	Application result code. Successful responses use 0 or 200.
message	string	Human-readable response or error message when present.
data.task_id	string	Task identifier used in the status endpoint path.
data.status	string	Current state: not_started, running, finished or failed.
data.created_time	string	Task creation time in date-time format.
data.progress	number	Completion percentage when the provider reports progress.
data.files[]	array	Generated output files returned after a successful task.
data.files[].file_url	string	Public URL of the generated video.
data.files[].file_type	string	Generated file type, such as video.
data.files[].watermark_url	string \| null	Watermarked output URL when one is available.
data.error_message	string \| null	Failure detail when status is failed.

Task Lifecycle

Treat not_started and running as non-terminal states. finished and failed are terminal; stop polling when either is returned.

not_started
The task has been accepted and is queued to start.
running
The video is being generated. Keep polling the status endpoint.
finished
The task is complete. Read the video URL from data.files[].file_url.
failed
Generation failed. Read data.error_message for details and stop polling.

Polling and Errors

Authentication401 means the Bearer API key is missing or invalid. Check your key in the dashboard before retrying.
Validation400 means a request field is invalid or belongs to another endpoint. Check image_urls (1–2 URLs) and prompt or multi_prompt.
Polling intervalPoll every few seconds while the task runs, and lengthen the interval gradually for longer clips.
Terminal statesPoll only while the status is not_started or running. Stop on finished or failed.
Callback optionAdd callback_url at the request root to receive the final result without continuous polling.

Model Specifications

Specification	Value	Description
Model	kwaivgi/kling-v4.0/image-to-video	Model identifier for asynchronous image-to-video generation with an optional end frame.
Duration	3–30	Whole seconds; defaults to 5.
Resolution	720p \| 1080p	Defaults to 720p.
Pricing	28.5 / 42.5 credits/s	720p / 1080p, per output second.

View the Kling 4.0 Image to Video API documentation

Kling 4.0 Image to Video

Kling 4.0, released by Kuaishou's Kling AI in October 2026, uses your image as the opening frame and can plan its way to a closing frame you supply. Clips run up to 30 seconds in one pass, long enough for a full action rather than a brief loop, and multi_prompt lets the motion unfold in timed shots. The output frame follows the start image, and a stereo track is included.

Why choose the Kling 4.0 Image to Video API?

Start and end frame controlSend one image to animate it or two to fix where the clip begins and ends.
Up to 30 seconds from one imageLong enough for a complete action, a slow reveal or a full camera move.
Timed shots from one frameUse multi_prompt to break the motion into shots with their own durations.
Sound includedA stereo track comes with every clip; describe footsteps, voices or ambience in the prompt.

Parameters

Parameter	Requirement	Description
prompt	Required unless multi_prompt is sent	One prompt for the whole clip, 1–26,000 characters after trimming. Describe action, camera, and any dialogue, effects or ambience. Send either prompt or multi_prompt. Default`—`
multi_prompt	Required unless prompt is sent	A list of shots, each {prompt (1–512 characters), duration (1–30 s, default 5)}. Shot durations must total 3–30 seconds and set the clip length. Default`—`
image_urls	Required	1–2 public HTTP(S) image URLs: the start frame, then an optional end frame. The output follows the start image's shape. Default`—`
duration	Optional	Output length in seconds, 3–30. With multi_prompt it defaults to the shot total. Default`5`
resolution	Optional	720p or 1080p. The resolution sets the per-second rate. Default`720p`

How to Use

Prepare the framesUse a clear start image; add an end image with similar framing when you want a fixed finish.
Describe the motionWrite what happens between the frames, the camera move, and the sounds.
Set length and resolutionPick 3–30 seconds and 720p or 1080p; the frame shape follows the start image.
Submit and collect the videoSend image_urls in order, then poll with the task_id or wait for callback_url.

Usage and billing

Kling 4.0 Image to Video is billed per output second at the selected resolution; input images add nothing.

Usage	Rate	Details
720p	28.5 credits / second	$0.1425 / output second. 5 seconds = 142.5 credits ($0.7125); 30 seconds = 855 credits ($4.275).
1080p	42.5 credits / second	$0.2125 / output second. 10 seconds = 425 credits ($2.125); 30 seconds = 1,275 credits ($6.375).

Best Use Cases

Product shots from stillsMove from a hero still to the product in use with start and end frames.
Character performanceGive a portrait a full action with a line of dialogue.
Illustration and key art motionAdd camera movement and life to approved artwork without redrawing it.
Transitions between two statesShow a space, outfit or object changing from one image to another.

Pro Tips

Describe what changes after the first frame instead of repeating what the image already shows.
Keep camera angle and scale close between start and end images for a smooth path.
Use multi_prompt when the action has clear stages, such as approach, reach and turn.
Upload JPEG, PNG or WebP images; public URLs must be reachable without login.

Notes

image_urls takes 1–2 public URLs in order: start frame, then optional end frame. The output frame follows the start image.
Send exactly one of prompt or multi_prompt.
Credits are output seconds × the resolution rate and are reserved when the task is submitted.

Related Models

PixVerse V6 Max Text to VideoPixVerse V6 Max Text to Video turns a prompt into 1–15 second videos at 360p to 1080p, with eight aspect ratios and an optional native audio track for dialogue, effects and music. Describe subjects, actions and sound in one prompt, then pick the length and format for each placement.

PixVerse V6 Max Image to VideoPixVerse V6 Max Image to Video animates one JPEG, PNG or WebP image into a 1–15 second video at 360p to 1080p, with an optional native audio track. The image sets the subject and framing, and a prompt of up to 2,048 characters directs motion, camera and sound.

OmniHuman 2.0 Audio to VideoOmniHuman 2.0 Audio to Video turns one character image and 4–300 seconds of speech or music into a 720p video, with lips, expression and gestures following the audio. The image keeps the character's look and framing, while an optional prompt adds camera moves and actions.

FLUX 3 Max Text to VideoFLUX 3 Max Text to Video turns a written shot into a 5–20 second 720p or 1080p video with native audio and eight aspect ratios. It follows the camera moves, lighting and sound cues you describe, so one prompt returns picture and audio together.

FLUX 3 Max Image to VideoFLUX 3 Max Image to Video animates a start image into a 5–20 second 720p or 1080p clip with native audio, optionally landing on an end frame you supply. It keeps the composition, subject and palette of your images while adding the motion and sound in the prompt.

FLUX 3 Max Keyframes to VideoFLUX 3 Max Keyframes to Video turns 1–10 images pinned to exact frames into a single 5–20 second 720p or 1080p clip with native audio. Each image appears at the frame_index you set on a 24 fps timeline, so the story beats land where you planned them.

Kling 4.0 Text to VideoKling 4.0 Text to Video turns a prompt or multi-shot script into one 3–30 second 720p or 1080p video with stereo audio and five aspect ratios. It keeps scenes coherent across long takes and shot changes while following your camera, dialogue and sound directions.

Kling 4.0 Reference to VideoKling 4.0 Reference to Video turns reference images, videos and reusable elements into a 3–30 second 720p or 1080p video with stereo audio, cited as @Image1, @Video1 or @Element1. It keeps characters, products and settings consistent with your references inside the new scene you describe.

Kling 4.0 Video EditKling 4.0 Video Edit transforms an existing 3–30 second video from a written instruction, restyling scenes, swapping objects or adding elements at 720p or 1080p. It keeps the original timing, people and camera path that you ask to preserve while applying the change across every frame.

Vidu Q4 Image to VideoVidu Q4 Image to Video turns one start image and an optional motion prompt into a 3–16 second clip at 540p up to 4K. Your image sets the opening frame, so subject, setting and aspect ratio carry through while the prompt directs movement and camera.

Vidu Q4 Reference to VideoVidu Q4 Reference to Video combines a prompt with up to 12 reference images and 3 voice clips into 3–16 second videos at up to 4K. Tag each reference in the prompt to keep characters, products and places recognisable, with optional generated audio at no extra cost.

Gemini Omni 1.1 Flash Text-to-Video preview

Gemini Omni 1.1 Flash Text-to-VideoGemini Omni 1.1 Flash Text-to-Video. Create 4–10 second videos with native audio from text, directing camera, lighting, and sound.

Gemini Omni 1.1 Flash Image-to-Video preview

Gemini Omni 1.1 Flash Image-to-VideoGemini Omni 1.1 Flash Image-to-Video. Animate a start image with native audio and add an optional end frame to guide the closing shot.

Gemini Omni 1.1 Flash Reference-to-Video preview

Gemini Omni 1.1 Flash Reference-to-VideoGemini Omni 1.1 Flash Reference-to-Video. Use 1–7 images to guide characters, products, and style in new video scenes with sound.

Gemini Omni 1.1 Flash Video Edit preview

Gemini Omni 1.1 Flash Video EditGemini Omni 1.1 Flash Video Edit. Edit 3–10 second videos through natural language with up to 5 reference images for visual guidance.

MiniMax H3 Max Turbo Text to Video preview

MiniMax H3 Max Turbo Text to VideoMiniMax H3 Max Turbo Text to Video turns text into coherent 5–15 second videos with synchronized native stereo audio and fast generation. It follows physical motion while rendering subtle changes in light and shadow.

Kling 4.0 Image to Video API FAQ

What is the Kling 4.0 Image to Video API?

Kling 4.0 Image to Video is a Kuaishou model for animating still images, released by Kling AI in October 2026. It turns a start image, and optionally an end image, into a 3–30 second video at 720p or 1080p with a stereo audio track. The model keeps the subject and framing of your image as the opening frame and plans the motion toward the end frame when you provide one. You can call it programmatically or try it from the playground above.

How do start and end frames work in Kling 4.0 Image to Video?

List the URLs in image_urls in order. The first image opens the clip and a second image, if present, is where it ends; the prompt describes how to get from one to the other.

What aspect ratio does Kling 4.0 Image to Video use?

The output follows the shape of the start image. Crop the image to 16:9, 9:16 or another ratio before uploading to set the frame.

Can Kling 4.0 Image to Video use multiple shots from one image?

Yes. Send multi_prompt instead of prompt to split the clip into shots with their own descriptions and durations, totalling 3–30 seconds.

How much does Kling 4.0 Image to Video cost?

It costs 28.5 credits ($0.1425) per output second at 720p and 42.5 credits ($0.2125) at 1080p. A 6-second 720p clip is 171 credits.

How long can a Kling 4.0 Image to Video clip run?

From 3 to 30 seconds in one pass, defaulting to 5. Longer clips work best when the prompt describes several stages of the action.

When should I use Kling 4.0 Reference to Video instead of Image to Video?

Image to Video locks your image as the first frame. Choose Reference to Video when you want a character, product or setting carried into new scenes without fixing the opening frame, or when you need several references at once.