v1

latestOpenAPI 3.0.32026-07-241112213.6 KB

Submit Omni Reference Task

Submit an Omni Reference video generation task. Omni Reference is an advanced video editing/generation feature that supports reference images and videos to guide the generation process. Supports multiple AI models with customizable resolution, aspect ratio, duration, and other parameters.

post/v1/common_task/omni_reference/task/submit

Headers

Topview-Uidstring required

User ID

Authorizationstring required

API Key for authentication

Request body

modelstring required

Model name, e.g., 'Kling O3 Video-Edit', 'Kling O1 Video-Edit', etc.

promptstring required

Positive prompt describing the video to generate. Supports reference syntax: <<<ImageN>>> for image references and <<<VideoN>>> for video references (e.g., '<<<Image1>>> person dancing to <<<Video1>>> background')

aspectRatiostring

Aspect ratio such as '16:9', '9:16', '1:1', etc. (optional, depends on model support)

resolution480 | 720 | 1080

Video resolution: 480 or 720 or 1080 (optional)

durationinteger

Video duration in seconds. Supported values depend on the model used (optional)

generatingCountinteger

Number of videos to generate: 1-4 (optional, default: 1)

internetSearchboolean

Whether to enable internet search for better results (optional, default: false)

boardIdstring

Board ID. When provided, creates a board task record in the system (optional)

noticeUrlstring

Callback URL for task completion notifications. Please refer to the API documentation for details (optional)

Response

Task submitted successfully

codestring

Response status code

messagestring

Response message

Example response

{
  "code": "200",
  "message": "Success"
}