videostringrequired
Reference video URL. Only .mp4/.mov formats, 3-10s duration, 720-2160px resolution, max 200MB.
Kling O3 4K Video Edit
30% OFF
kwaivgi/kling-video/o3/4k/editKling O3 4K Video Edit by Kuaishou edits an input video from a text instruction, optionally guided by reference images, at native 4K.
Try the model
Playground
Input
Text prompt for video generation. Reference video as @Video1.
Reference video URL. Only .mp4/.mov formats, 3-10s duration, 720-2160px resolution, max 200MB.
Additional Settings More
Customize your input with more control.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video.
The type of multi-shot video generation.
Whether to keep the original audio from the reference video.
ResultExample
What would you like to do next?
Examples
Select an example to load its inputs and result into the playground.
- Open result ↗
Input
{ "prompt": "Change environment to be fully snow as @Image1. Replace animal with @Element1", "video": "https://static.sandbase.ai/examples/9a3754af-416e-4d82-9080-086173a5abf6/input/ccf25009-a184-4290-9917-1ac770a9a29e.mp4" }
Kling O3 4K Video Edit
Kling O3 4K video edit: change an existing clip with an instruction, such as restyling it or swapping objects or people, while motion and camera are kept. Reference images can supply the new look.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 2,500 characters. |
images | image URL[] | — | Optional reference images, @Image1, @Image2, … |
video | video URL, required | — | Source clip, @Video1 in the prompt. |
shot_type | string | customize | customize follows your multi_prompt shot list; intelligent lets the model plan the cuts. |
keep_audio | boolean | true | Keep the source video's audio track. |
Billing
You pay $0.42 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 | $1.26 |
| 5s source | $2.10 |
| 10s source | $4.20 |
| 15s source | $6.30 |
Failed runs are not charged.
Prompting
- Lead with the change and say what must stay: “replace the jacket with @Image1; keep the walk and the camera”.
Limits
- Output length follows the source video.
Also on SandBase
Other Kling O3 4K endpoints and tiers: kwaivgi/kling-video/o3/4k/text-to-video, kwaivgi/kling-video/o3/4k/image-to-video, kwaivgi/kling-video/o3/4k/reference-to-video, kwaivgi/kling-video/o3/4k/video-to-video, kwaivgi/kling-video/o3/standard/edit, kwaivgi/kling-video/o3/pro/edit.
Start building
Send your first request
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/o3/4k/edit",
"video": "https://static.sandbase.ai/examples/kwaivgi/mirrored/example_inputs/kling-o3/pro-v2v-edit/video_reference.mp4",
"images": [
"https://static.sandbase.ai/examples/kwaivgi/mirrored/example_inputs/kling-o3/pro-v2v-edit/image_url1.jpg"
],
"prompt": "Change environment to be fully snow as @Image1. Replace animal with @Element1",
"shot_type": "customize",
"keep_audio": true
}
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"2. Authentication
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.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
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"4. Files
Hosted files
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.
Uploading images
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.
5. Schema
Input
imagesarray
Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video.
promptstringrequired
Text prompt for video generation. Reference video as @Video1.
shot_typestring
The type of multi-shot video generation.
Default: "customize"
keep_audioboolean
Whether to keep the original audio from the reference video.
Default: true
{
"model": "kwaivgi/kling-video/o3/4k/edit",
"video": "https://static.sandbase.ai/examples/kwaivgi/mirrored/example_inputs/kling-o3/pro-v2v-edit/video_reference.mp4",
"images": [
"https://static.sandbase.ai/examples/kwaivgi/mirrored/example_inputs/kling-o3/pro-v2v-edit/image_url1.jpg"
],
"prompt": "Change environment to be fully snow as @Image1. Replace animal with @Element1",
"shot_type": "customize",
"keep_audio": true
}Output
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/85513ed0d7d10db979c7.jpg",
"source": "Kling AI official schema mirror",
"source_url": "https://kling.ai/document-api/guides/get-started/overview",
"url": "https://static.sandbase.ai/examples/9a3754af-416e-4d82-9080-086173a5abf6/output/d6db0f2f-26c2-4aeb-887e-5c1933cadd74.mp4"
}
]