OpenAI modelsvideo generation api

openai/sora-2/text-to-video/pro

Name: Sora 2 Text to Video Pro
Author: OpenAI

Sora 2 Pro by OpenAI - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation.

Input

Prompt(string)

The text prompt describing the video you want to generate

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Resolution(string)

The resolution of the generated video Allowed values: 720p, 1080p, true_1080p.

Duration(integer)

Duration of the generated video in seconds Allowed values: 4, 8, 12, 16, 20.

Character IDs(array)

Up to two character IDs (from create-character) to use in the video. Refer to characters by name in the prompt. When set, only the OpenAI provider is used.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDopenai/sora-2/text-to-video/pro

Input Schema

5 parameters · 1 required · 4 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The text prompt describing the video you want to generate · Min length: 1 · Max length: 5000
`duration`	integer	Optional	Duration of the generated video in seconds · Options: 4, 8, 12, 16, 20 · Default: 4 48121620
`resolution`	string	Optional	The resolution of the generated video · Options: 720p, 1080p, true_1080p · Default: "1080p" 720p1080ptrue_1080p
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`character_ids`	string[]	Optional	Up to two character IDs (from create-character) to use in the video. Refer to characters by name in the prompt. When set, only the OpenAI provider is used.

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "openai/sora-2/text-to-video/pro",
  "prompt": "A dramatic Hollywood breakup scene at dusk on a quiet suburban street. A man and a woman in their 30s face each other, speaking softly but emotionally, lips syncing to breakup dialogue. Cinematic lighting, warm sunset tones, shallow depth of field, gentle breeze moving autumn leaves, realistic natural sound, no background music",
  "duration": 4,
  "resolution": "1080p"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Sora 2 Text to Video Pro

API README

Sora 2 Text To Video PRO

Sora 2 Text To Video PRO is the Sora 2 route for pro, turning the documented source inputs into a production-ready result while keeping the operation distinct from neighboring endpoints. Sora 2 Pro by OpenAI - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation. The workflow is designed for creators who need the model’s specific transformation to remain visible in the request, so the source, intended change, and finished artifact can be reviewed as one coherent creative decision.

In practical use, this route exposes prompt, duration, resolution, aspect_ratio, character_ids to shape the exact deliverable. Those controls let a team preserve the important source constraints, state subject behavior or material treatment precisely, choose supported timing or output characteristics, and reproduce successful settings across alternate takes. The result fits an iterative pipeline: establish the core brief, compare controlled variations, then pass the selected asset into editorial, design, localization, visualization, or publishing work.

Highlights

Route-specific creation. Use this exact route for pro with its documented input contract. This capability belongs to the exact openai/sora-2/text-to-video/pro workflow.
Scene continuity. Maintain subjects, environments, and motion across the generated or remixed shot.
Directable cinematography. Express action, camera movement, framing, pacing, and visual tone in the prompt.
Resolution and timing choices. Select the documented duration and delivery format appropriate to this Sora 2 route.

Pricing

Configuration	Price
Formula rate · standard/720p	`$0.300000 per second`
Formula rate · 1080p legacy	`$0.500000 per second`
Formula rate · true 1080p	`$0.700000 per second`
4s · 720p standard	`$1.20`
4s · 1080p legacy	`$2.00`
4s · true_1080p	`$2.80`
8s · 720p standard	`$2.40`
8s · 1080p legacy	`$4.00`
8s · true_1080p	`$5.60`
12s · 720p standard	`$3.60`
12s · 1080p legacy	`$6.00`
12s · true_1080p	`$8.40`
16s · 720p standard	`$4.80`
16s · 1080p legacy	`$8.00`
16s · true_1080p	`$11.20`
20s · 720p standard	`$6.00`
20s · 1080p legacy	`$10.00`
20s · true_1080p	`$14.00`

When to Use

Scenario	Why it fits
Exact workflow fit	Choose this route when the required deliverable is pro, rather than a related route with different source media.
Directed creative iteration	Use it when subject, motion, material, speech, framing, or finish should be expressed explicitly and compared across controlled variants.
Existing-asset continuity	Use it when supplied images, video, audio, references, or styles must remain the anchor for the generated result.
Repeatable production	Use it when successful inputs need to be saved and rerun across a campaign, asset set, localization pass, or batch.
Pipeline handoff	Use it when the returned artifact will move into editorial, compositing, visualization, review, storage, or publishing.

Prompt Guide

Start with the source or subject, then describe the intended transformation, movement or behavior, camera and composition, and the desired finish. Keep media URLs reachable, use only fields documented for this exact route, and change one major control at a time when comparing results. For source-led tasks, describe what should change as well as what must remain recognizable.

{
  "prompt": "A dramatic Hollywood breakup scene at dusk on a quiet suburban street. A man and a woman in their 30s face each other, speaking softly but emotionally, lips syncing to breakup dialogue. Cinematic lighting, warm sunset tones, shallow depth of field, gentle breeze moving autumn leaves, realistic natural sound, no background music",
  "duration": 4,
  "resolution": "1080p",
  "aspect_ratio": "21:9"
}

Technical Specs

Property	Value
Model ID	`openai/sora-2/text-to-video/pro`
Execution mode	`async`
Required inputs	`prompt`
`prompt`	string
`duration`	integer; options: 4, 8, 12, 16, 20; default: 4
`resolution`	string; options: 720p, 1080p, true_1080p; default: 1080p
`aspect_ratio`	string; options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16
`character_ids`	array

Related Models

openai/sora-2/image-to-video/pro
openai/sora-2/video-to-video/remix
openai/sora-2/characters
openai/sora-2/image-to-video