Generate a video

curl --request POST \
  --url https://api.opper.ai/v3/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>"
}
'

{
  "id": "<string>",
  "status_url": "<string>"
}

Video

Generate a video

Submit a deterministic video-generation job. Returns immediately with a generation id and a status URL to poll; the video is produced asynchronously. model and prompt are required; everything in parameters is forwarded verbatim to the provider. image/video/reference_images accept an http(s) URL, a data-URI, or a file_<id> (resolved per provider). Output is saved to /v3/files by default and returned with a reusable file_id on the status poll; set store: false to opt out. Poll the returned status_url (GET /v3/artifacts//status) for a presigned download URL when complete.

POST

videos

Generate a video

curl --request POST \
  --url https://api.opper.ai/v3/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>"
}
'

{
  "id": "<string>",
  "status_url": "<string>"
}

Video generation is asynchronous: this returns 202 with an id and a status_url. Poll GET /v3/artifacts/{id}/status until completed, then download from the presigned url. See the Video guide for the end-to-end flow, reference image/video inputs, and per-provider parameters.

Authorizations

Authorization

string

header

required

API key authentication. Pass your API key as a Bearer token.

Body

application/json

model

string

required

prompt

string

required

aspect_ratio

string

image

string

last_image

string

parameters

object

reference_images

string[]

resolution

string

seconds

integer

size

string

store

boolean

Persist the finished video to /v3/files and return a reusable file_id on the status poll. Defaults to true; set false to skip.

video

string

Response

Successful response

string

required

status_url

string

required

List audio models List video models

⌘I