Skip to main content
POST
Create a video generation job

Body

application/json

Video creation request

model
string
required

Model ID to use

prompt
string
required

Text prompt describing the video

input_reference
string | null

Optional reference video or asset as URL, data URI, base64 string, or file path

seconds
integer
default:4
size
default:1280x720
fps
integer
default:16
num_inference_steps
integer
default:25
guidance_scale
number
default:5

Response

200 - application/json

Video generation job created

Structured information describing a generated video job

id
string
required
object
enum<string>
default:video
required
Available options:
video
created_at
integer
required
model
string
required
seconds
integer
required
size
string
required
status
enum<string>
required

Video generation lifecycle states

Available options:
queued,
in_progress,
completed,
failed
completed_at
integer | null
error
object

Video generation error details

expires_at
integer | null
prompt
string | null