Skip to main content
POST

Authorizations

​
x-key
string
header
required

Body

application/json
​
prompt
string
required

Free-form prompt describing the video.

​
mode
enum<string>
required
Available options:
t2v
​
aspect_ratio
default:auto

Output aspect ratio. auto lets the harness choose from the prompt and any references.

Available options:
21:9,
2:1,
16:9,
4:3,
1:1,
3:4,
9:16
​
duration
default:auto

Video duration in seconds (any whole second from 5 to 20), or auto to fit the content.

Required range: 5 <= x <= 20
​
resolution
enum<string>
default:hd

Video resolution class: hd, or fhd for a higher-resolution result finished by the video upsampler. Exact dimensions vary with the aspect ratio.

Available options:
hd,
fhd
​
version
enum<string>
default:latest

Endpoint version. latest (default) serves the current release; dated pinnable release tags are added here as they are published.

Available options:
latest
​
generate_audio
boolean
default:true

Generate synchronized audio alongside the video.

​
safety_tolerance
integer
default:2

Tolerance level for input and output harm moderation. Between 0 and 4, with 0 the strictest. Sexual content is limited to level 3 and hate content to level 2 regardless of the requested tolerance. Contextual safety signals can tighten the requested level. Requests with conditioning media are limited to level 2.

Required range: 0 <= x <= 4
​
draft
boolean
default:false

Draft mode: generate a fast preview and return a draft_cache download URL in the result. Download that bundle and send it back with mode: "draft_enhance" to render the full-quality version of the same generation.

Response

Successful Response

​
id
string
required
​
polling_url
string
required
​
cost
number | null

Cost in credits for this request

​
input_mp
number | null

Input megapixels (2 decimal places)

​
output_mp
number | null

Output megapixels (2 decimal places)