OpenAI Sora 2 — Text to Video


Model ID	`openai/sora-2-t2v`
Family	`sora-2`
Task	`text-to-video`
Modality	Video
Upstream	OpenAI Sora 2

Need 1080p output? Use the Sora 2 Pro Text-to-Video variant (openai/sora-2-pro-t2v). Pricing differs significantly.

Endpoint

POST https://routerbase.com/v1/videos/generations

Async — returns {id, status: "pending"}; poll GET /v1/videos/generations/{id} until success or failed.

Parameters

string

required

Text prompt describing the desired video. Sora 2 also synthesizes audio cues from the prompt — describing sound design (e.g. “ambient rain”) tends to produce richer results. Maximum 2000 characters — longer prompts are rejected with 400 invalid_request_error.

"4" | "8" | "12"

default:"\"4\""

Length of the generated clip in seconds. This is the only price lever — see pricing.

Example

curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/sora-2-t2v",
    "prompt": "a calm beach at sunrise, gentle waves, soft ambient sound",
    "duration": "8"
  }'

{ "id": "vid_abc123…", "status": "pending", "model": "openai/sora-2-t2v" }

Poll until terminal:

curl https://routerbase.com/v1/videos/generations/vid_abc123… \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY"

{
  "id": "vid_abc123…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}

Try it live in the Sora 2 Playground.

Get Started

API Reference

OpenAI Sora 2 — Text to Video

Endpoint

Parameters

Example

​Endpoint

​Parameters

​Example

Endpoint

Parameters

Example