Skip to main content
Use model_name: "kling-3.0-omni" with POST /kling/v1/videos/omni-video. Text, image, video, and element inputs are capabilities of this model.

Create Task

POST /kling/v1/videos/omni-videoUse model_name: "kling-3.0-omni" with text, images, video, and elements for generation or editing.
cURL

Request headers

string
required
Bearer authentication in the form Bearer YOUR_API_KEY.
string
default:"application/json"
required
Data exchange format. Use application/json.

Request parameters

string
required
Use kling-3.0-omni.
string
Up to 2,500 characters; reference media with the official placeholders.
object[]
Reference images and optional first/end frames.
object[]
At most one reference video, including refer_type and keep_original_sound.
object[]
Element count depends on whether a video is supplied.
boolean
default:false
Enable multi-shot generation.
string
Use customize or intelligence.
object[]
One to six custom shots.
string
default:"pro"
Use std, pro, or 4k.
string
Use 16:9, 9:16, or 1:1 when applicable.
string
default:"5"
3–15 seconds; ignored for refer_type: "base".
string
default:"off"
Must be off when video_list is present.
object
Platform watermark setting.
string
required
Reference image URL or raw Base64.
string
first_frame or end_frame; an end frame requires a first frame.
string
required
Reference video URL.
string
default:"base"
base edits the source video; feature references its characteristics.
string
Use yes or no.
integer
required
Element ID from element management.
integer
required
Shot index.
string
required
Shot prompt, up to 512 characters.
string
required
Shot duration, at least 1 second.
boolean
default:false
Add the platform watermark.

Create response

200
string
AnyFast task ID.
string
Task ID, equal to id.
string
Always video.
string
kling-v3-omni.
string
Initial task status.
integer
Initial progress.
integer
Creation Unix timestamp.

Media constraints

Images accept URL or raw Base64, JPG/JPEG/PNG, up to 10 MB, at least 300 px per side, and aspect ratio 1:2.5 to 2.5:1. An end frame requires a first frame. Without a reference video, images plus multi-image elements total at most 7 and video-character elements at most 3. With a reference video, those limits become 4 and 1.Reference video accepts MP4/MOV, 3–15.5 seconds, up to 200 MB, 24–60 fps, dimensions 700–4553 px, no more than 8,294,400 pixels, and aspect ratio 1:2.5 to 2.5:1.refer_type: "base" edits the original video, preserves its duration, and disables multi-shot and first/end-frame controls. refer_type: "feature" references content, motion, style, or camera movement and can use intelligent multi-shot. keep_original_sound controls source audio; new sound generation is unavailable whenever a reference video is present.

Query task by ID

GET /kling/v1/videos/omni-video/{task_id}

Request headers

string
required
Bearer authentication in the form Bearer YOUR_API_KEY.
string
default:"application/json"
required
Data exchange format. Use application/json.

Path parameters

string
required
Omni-video task ID returned by the create endpoint.
cURL

Query response

200

Response fields

integer
0 indicates that the query was accepted.
string
Error information; empty for a successful query.
string
Queried task ID.
string
submitted, processing, succeed, or failed.
string
Failure details when the task fails.
object[]
Generated videos, returned after success.
string
Temporary generated-video URL.
string
Actual duration in seconds.
integer
Creation Unix timestamp in milliseconds.
integer
Last update Unix timestamp in milliseconds.
AnyFast adds the /kling route prefix to Kling’s Legacy API. Creation and task-query paths remain capability-specific.