openai/sora-2/text-to-video
Sora 2 by OpenAI - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runopenai/sora-2/text-to-videoInput Schema
4 parameters · 1 required · 3 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 · Default: "720p" |
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 · Default: "16:9" 21:916:93:24:35:41:14:53:42:39:16 |
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, ortimeout - Retrieve — Read
outputsfrom 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",
"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": "720p",
"aspect_ratio": "16:9"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Sora 2 Text To Video
Sora 2 Text To Video is the Sora 2 route for text-to-video generation, turning a written scene brief into a production-ready result while keeping the operation distinct from neighboring endpoints. Sora 2 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, sync_mode, resolution, aspect_ratio, delete_video, character_ids, safety_tolerance 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
- Prompt-built scenes. Create the shot directly from written direction covering subject, setting, action, camera, and visual treatment.
- 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 |
|---|---|
| 4 seconds | $0.40 |
| 8 seconds | $0.80 |
| 12 seconds | $1.20 |
| 16 seconds | $1.60 |
| 20 seconds | $2.00 |
When to Use
| Scenario | Why it fits |
|---|---|
| Exact workflow fit | Choose this route when the required deliverable is text-to-video generation, 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 cinematic close shot with clear subject action, camera movement, lighting, and final visual treatment.",
"duration": 4,
"resolution": "720p",
"aspect_ratio": "16:9"
}
Technical Specs
| Property | Value |
|---|---|
| Model ID | openai/sora-2/text-to-video |
| Execution mode | async |
| Required inputs | prompt |
prompt | string |
duration | integer; options: 4, 8, 12, 16, 20; default: 4 |
sync_mode | boolean; default: false |
resolution | string; default: 720p |
aspect_ratio | string; options: 9:16, 16:9; default: 16:9 |
delete_video | boolean; default: true |
character_ids | array |
safety_tolerance | string; default: 6 |
detect_and_block_ip | boolean; default: false |
Related Models
openai/sora-2/charactersopenai/sora-2/image-to-videoopenai/sora-2/image-to-video/proopenai/sora-2/text-to-video/pro