API docs / Video models

Sora 2 Pro API

Generates videos with synchronized audio from text prompts or optional reference images. Supports video durations of 4, 8, or 12 seconds with standard 720p resolution or high 1024p resolution. Offers both portrait and landscape aspect ratios. Can use an input image as the first frame of the generated video, with the requirement that the image matches the video's aspect ratio.

Model id
openai/sora-2-pro
Provider
openai
Output
Video
Price
From 419 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "openai/sora-2-pro". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "openai/sora-2-pro",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

A text description of the video to generate

first_framearray of URLs

An optional image to use as the first frame of the video. The image must be the same aspect ratio as the video.

Up to 1 files · Accepts image/*

aspect_ratiostring

Default: portrait

One of: portrait, landscape

resolutionstring

Default: standard

One of: standard, high

duration_secondsnumber

Default: 4

One of: 4, 8, 12