kwaivgi/kling-video/3.0/omni/pro/video-to-video/editKling 3.0 Omni Pro Video Edit by Kuaishou edits an input video from a text instruction, optionally guided by reference images, at 1080p.
Try the model
Customize your input with more control.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
What would you like to do next?
Select an example to load its inputs and result into the playground.
{
"prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
"video": "https://static.sandbase.ai/examples/d8e6723f-c5f2-49ea-8e92-d15dbfdb8702/input/e08df747-4f43-46f7-b259-dbfde5b1a6c6.mp4"
}Kling 3.0 Omni Pro video edit: change an existing clip with an instruction and optional reference images, keeping its motion and timing.
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 2,500 characters. |
images | image URL[] | — | Optional reference images, @Image1, … |
video | video URL, required | — | Source clip, @Video1 in the prompt. |
elements | object[] | — | Optional character or object elements to keep consistent. |
keep_audio | boolean | false | Keep the source video's audio track. |
$0.168 per second of the source video. The quote before submission assumes 15 seconds; the final charge uses the measured length.
| Source clip | Price |
|---|---|
| 3s source | $0.504 |
| 5s source | $0.84 |
| 10s source | $1.68 |
| 15s source | $2.52 |
Failed runs are not charged.
Other Kling 3.0 Omni endpoints: kwaivgi/kling-video/3.0/omni/pro/image-to-video, kwaivgi/kling-video/3.0/omni/pro/reference-to-video.
Start building
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "kwaivgi/kling-video/3.0/omni/pro/video-to-video/edit",
"video": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/video-to-video/edit/output_url_1.mp4",
"images": [
"https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/video-to-video/edit/input_images_0.png"
],
"prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
"elements": [
{
"frontal_image_url": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_0.png",
"reference_image_urls": [
"https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_1.png",
"https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_2.png"
]
}
],
"keep_audio": false
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
videostringrequiredReference video URL. Only .mp4/.mov formats supported, 3-10 seconds duration, 720-2160px resolution, max 200MB. Max file size: 200.0MB, Min width: 720px, Min height: 720px, Max width: 2160px, Max height: 2160px, Min duration: 3.0s, Max duration: 10.05s, Min FPS: 24.0, Max FPS: 60.0, Timeout: 30.0s
imagesarrayReference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video.
promptstringrequiredUse @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.
elementsarrayElements (characters/objects) to include. Reference in prompt as @Element1, @Element2, etc. Maximum 4 total (elements + reference images) when using video.
keep_audiobooleanWhether to keep the original audio from the video.
Default: false
{
"model": "kwaivgi/kling-video/3.0/omni/pro/video-to-video/edit",
"video": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/video-to-video/edit/output_url_1.mp4",
"images": [
"https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/video-to-video/edit/input_images_0.png"
],
"prompt": "Replace the character in the video with @Element1, maintaining the same movements and camera angles. Transform the landscape into @Image1",
"elements": [
{
"frontal_image_url": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_0.png",
"reference_image_urls": [
"https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_1.png",
"https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_2.png"
]
}
],
"keep_audio": false
}A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
[
{
"poster": "https://static.sandbase.ai/examples/posters/8e7d2cdb9f87b8e15531.jpg",
"source": "Kling AI official schema mirror",
"source_url": "https://kling.ai/document-api/guides/get-started/overview",
"url": "https://static.sandbase.ai/examples/d8e6723f-c5f2-49ea-8e92-d15dbfdb8702/output/852d22be-8bcd-4296-8447-455850a6965d.mp4"
}
]