sora-video

# Sora Video Generation Generate AI videos through AceDataCloud's OpenAI Sora API. > **Setup:** See [authentication](../_shared/authentication.md) for token setup. ## Quick Start ```bash curl -X POST https://api.acedata.cloud/sora/videos \ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"prompt": "a golden retriever running on a beach at sunset", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}' ``` > **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /sora/tasks` with `{"id": "..."}`. ## Models | Model | Duration | Quality | Best For | |-------|----------|---------|----------| | `sora-2` | 10–15s | Standard | Most tasks (default) | | `sora-2-pro` | 10–25s | Higher | Premium quality, longer videos | ## Workflows ### 1. Text-to-Video ```json POST /sora/videos { "prompt": "a busy Tokyo street at night with neon signs reflecting in rain puddles", "model": "sora-2", "size": "small", "duration": 10, "orientation": "landscape" } ``` ### 2. Image-to-Video Use reference images to guide generation. ```json POST /sora/videos { "prompt": "the scene gradually comes alive with gentle motion", "image_urls": ["https://example.com/scene.jpg"], "model": "sora-2", "orientation": "landscape" } ``` ### 3. Character-Driven Video Extract a character from an existing video and use them in a new scene. ```json POST /sora/videos { "prompt": "the character walks through a futuristic city", "character_url": "https://example.com/source-video.mp4", "character_start": 2, "character_end": 5, "model": "sora-2-pro" } ``` ## Parameters | Parameter | Values | Description | |-----------|--------|-------------| | `model` | `"sora-2"`, `"sora-2-pro"` | Model to use (required) | | `size` | `"small"`, `"large"`, `"720x1280"`, `"1280x720"`, `"1024x1792"`, `"1792x1024"` | Video resolution | | `duration` | `4`, `8`, `10`, `12`, `15`, `25` | Duration in seconds (25 only with sora-2-pro; version 2.0 supports 4/8/12) | | `orientation` | `"landscape"` (16:9), `"portrait"` (9:16) | Video orientation — version 1.0 only | | `version` | `"1.0"` (default), `"2.0"` | API version. `1.0` enables duration up to 25s, `orientation`, character references and image inputs; `2.0` uses pixel `size` values and drops `orientation` | ## Gotchas - Duration of **25 seconds** is only available with `sora-2-pro` model - `size: "large"` produces higher resolution but costs more and takes longer - Character-driven generation requires `character_start` and `character_end` timestamps (in seconds) from the source video - `orientation` sets the aspect ratio — use `"portrait"` for mobile-first content - Task states use `"succeeded"` (not "completed") — check for this value when polling > **MCP:** `pip install mcp-sora` | Hosted: `https://sora.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)