Skip to main content
POST
Create video task

Authorizations

Authorization
string
header
required

An API key created in the OmniRelay console. The owner can view it again in the console after confirming their identity.

Headers

X-Gateway-Tags
string

Tags for this call as comma-separated key=value pairs, for example client=acme,env=prod. Merged with the API key's default tags; the tags body field wins on the same key. X-OmniRelay-Tags is the same header under its former name and stays accepted.

Body

application/json
model
string
required

A video model ID from GET /v1/models (type video).

Example:

"doubao-seedance-2-0-260128"

content
object[]
required

Exactly one text item, 1 to 4000 characters.

Required array length: 1 element
resolution
enum<string>
default:480p
Available options:
480p,
720p
ratio
enum<string>
default:16:9
Available options:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
duration
integer
default:5

Length in whole seconds.

Required range: 4 <= x <= 10
seed
integer
Required range: -1 <= x <= 4294967295
generate_audio
boolean

The clip has a soundtrack unless this is false.

watermark
boolean
camera_fixed
boolean

Response

Task accepted and its hold dispatched.

id
string
required

Task ID. Poll it with GET /api/v3/contents/generations/tasks/{id}.