Submit Task

post

https://api.topview.ai/v1/common_task/omni_reference/task/submit

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

model

string

required

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

prompt

string

required

Defaults to A professional video with <<<Image1>>> as main subject

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

inputImages

array of objects

List of reference images. Each image can be referenced in prompt using <<>> syntax (optional)

inputImages

inputVideos

array of objects

List of reference videos. Each video can be referenced in prompt using <<>> syntax (optional)

inputVideos

aspectRatio

string

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

resolution

integer

enum

Video resolution: 480 or 720 or 1080 (optional)

Allowed:

duration

integer

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

generatingCount

integer

1 to 4

Defaults to 1

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

internetSearch

boolean

Defaults to false

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

boardId

string

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

noticeUrl

string

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

Headers

Topview-Uid

string

required

Defaults to <your-topview-uid>

User ID

Authorization

string

required

Defaults to Bearer <your-api-key>

API Key for authentication

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Task submitted successfully