OpenAI Sora 2 Pro — Image to Video


Model ID	`openai/sora-2-pro-i2v`
Family	`sora-2-pro`
Task	`image-to-video`
Modality	Video
Upstream	OpenAI Sora 2 Pro

Pro and Basic share the same upstream endpoint; the Pro variant flips professional: true server-side and unlocks the resolution parameter. Pricing differs significantly from Basic — see the quickstart.

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 motion or scene change. Audio cues in the prompt feed Sora 2’s synthesized audio track. Maximum 2000 characters — longer prompts are rejected with 400 invalid_request_error.

string[]

required

Exactly one source-image URL (PNG / JPEG, publicly accessible over HTTPS). Mapped to upstream image.

"4" | "8" | "12"

default:"\"4\""

Length of the generated clip in seconds.

"720p" | "1080p"

default:"\"720p\""

Output resolution. Pro unlocks 1080p; 720p is also available at the lower Pro price tier (see pricing).

Example — 720p

curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/sora-2-pro-i2v",
    "prompt": "the cat slowly turns its head and blinks, soft purr",
    "image_urls": ["https://example.com/cat.jpg"],
    "duration": "4",
    "resolution": "720p"
  }'

{ "id": "vid_xyz789…", "status": "pending", "model": "openai/sora-2-pro-i2v" }

Example — 1080p

curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/sora-2-pro-i2v",
    "prompt": "the dog leaps off the dock, splash, distant cheer",
    "image_urls": ["https://example.com/dog.jpg"],
    "duration": "8",
    "resolution": "1080p"
  }'

Poll until terminal:

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

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

Try it live in the Sora 2 Pro Playground.

Get Started

API Reference

OpenAI Sora 2 Pro — Image to Video

Endpoint

Parameters

Example — 720p

Example — 1080p

​Endpoint

​Parameters

​Example — 720p

​Example — 1080p

Endpoint

Parameters

Example — 720p

Example — 1080p