Kling 4.0 Video Edit

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/video-edit",
  "input": {
    "video_url": "https://example.com/street.mp4",
    "prompt": "Turn the street into a snowy winter evening and keep the people and camera motion unchanged",
    "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/video-edit",
  "input": {
    "video_url": "https://example.com/street.mp4",
    "prompt": "Turn the street into a snowy winter evening and keep the people and camera motion unchanged",
    "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 Video Edit changes an existing 3–30 second video from a text instruction: restyle the scene, swap objects or backgrounds, or adjust the action, while keeping the source motion. Reference images and image-based subjects can show exactly what to insert. 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/video-edit — Video edit with Kling 4.0: text-guided editing of a 3–30 second source video, 720p or 1080p.

Features

Text-guided video edit of a 3–30 second source clip.
Optional reference images (@Image1, …) and image-based elements (@Element1, …).
Output length matches the source by default, or set duration.
720p or 1080p output.

Required parameters

video_url (string): Public HTTP(S) URL of the source video, 3–30 seconds, up to 100 MB.
prompt (string): The edit instruction, 1–26,000 characters after trimming.

Optional parameters

duration (integer): Output length, 3–30 seconds. No default: if omitted, the output matches the source.
resolution (string): 720p or 1080p. Default 720p.
reference_image_urls (string[]): Up to 10 public HTTP(S) image URLs.
kling_elements (object[]): Up to 7 image-based elements, each {element_input_urls} with 2–4 image URLs. Video elements are not supported here.

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

Restyle, keep source length: a winter makeover of a street clip without duration, so the output follows the source.
Replace an object with a reference image, with callback: swap a phone for the product in @Image1, 10 seconds at 1080p, with a callback_url.

Notes

multi_prompt, image_urls, reference_video_urls, aspect_ratio and video-based elements are not supported on this ID and return 400.
The source video is downloaded and measured server-side; it must run 3–30 seconds and be at most 100 MB.
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 duration. When an input video is present, a separate input-video rate applies to billed seconds = output duration + the larger of the output duration and the total input video length (summed, then rounded up to whole seconds). A failed task is refunded in full. See the pricing page for current rates. Without duration, the output duration is billed as the source length rounded up.
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/video-edit.

Example:

"kwaivgi/kling-v4.0/video-edit"

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

​Required parameters

​Optional parameters

​Output

​Examples

​Notes

Authorizations

Body

Response

Models

Features

Required parameters

Optional parameters

Output

Examples

Notes