Video Generation

Because video generation takes a while, it works asynchronously: you start a job, poll its status, and download the video once it's ready.

1. Start a job

POST/v1/video/generations/jobs

Request parameters

Field	Type	Required	Description
model	string	✓	Video model
prompt	string	✓	Video description
width	integer		Width (pixels)
height	integer		Height (pixels)
n_seconds	integer		Video length (seconds)
n_variants	integer		Number of variants to generate

curl https://app.qevron.ai/v1/video/generations/jobs \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<video-model>",
    "prompt": "A robot walking on the beach, cinematic",
    "width": 1280, "height": 720, "n_seconds": 5, "n_variants": 1
  }'

Response

{
  "object": "video.generation.job",
  "id": "vidjob_abc123",
  "status": "queued",
  "created_at": 1716200000,
  "prompt": "A robot walking on the beach, cinematic",
  "model": "<video-model>"
}

status values: queued, processing, running, succeeded, failed.

2. Poll status

GET/v1/video/generations/jobs/{id}

curl https://app.qevron.ai/v1/video/generations/jobs/vidjob_abc123 \
  -H "Authorization: Bearer $QEVRON_API_KEY"

Poll at intervals until status is succeeded. When complete, the response includes a generations list.

3. Download the video

GET/v1/video/generations/{id}/content/video

curl https://app.qevron.ai/v1/video/generations/vidjob_abc123/content/video \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  --output video.mp4

The response is binary video data.

TIP

This workflow mirrors OpenAI's video generation API: create → wait → download.