Skip to main content
POST
Create an asynchronous video generation job
Calculates parameter-aware per-second pricing, reserves the maximum charge, and returns an asynchronous video job.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string
Required string length: 1 - 200

Body

application/json
model
enum<string>
required
Available options:
w3.0-video
prompt
string | null
Maximum string length: 20000
first_frame
Required string length: 1 - 2048
last_frame
Required string length: 1 - 2048
reference_images
(string<uri> | string)[] | null
Maximum array length: 10
Required string length: 1 - 2048
reference_videos
(string<uri> | string)[] | null
Maximum array length: 5
Required string length: 1 - 2048
reference_audios
(string<uri> | string)[] | null
Maximum array length: 5
Required string length: 1 - 2048
resolution
enum<string>
Available options:
480p,
720p,
1080p
ratio
enum<string>
Available options:
16:9,
4:3,
1:1,
3:4,
9:16,
adaptive
duration
integer
Required range: 2 <= x <= 30
audio
boolean
seed
integer | null
Required range: 0 <= x <= 2147483647
prompt_extend
boolean
webhook_url
string
Required string length: 1 - 2048

Response

Default Response

id
string
required
Pattern: ^job_[A-Za-z0-9_-]{20,64}$
object
enum<string>
required
Available options:
generation.job
created
integer
required
status
enum<string>
required
Available options:
queued,
submitted,
processing,
succeeded,
failed,
cancelled,
expired,
reconciliation_required
model
string
required
poll_url
string
required
completed
integer | null
reserved_amount
string
Pattern: ^[0-9]+\.[0-9]{4}$
currency
enum<string>
Available options:
USD
data
object[]
error
object | null
webhook_signing_secret
string
Pattern: ^whsec_[A-Za-z0-9_-]{43}$
Last modified on September 17, 2026