Sora Video Generation
Generate AI videos through AceDataCloud's OpenAI Sora API.
Setup: See authentication for token setup.
Quick Start
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. Poll via
POST /sora/taskswith{"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
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.
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.
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-promodel size: "large"produces higher resolution but costs more and takes longer- Character-driven generation requires
character_startandcharacter_endtimestamps (in seconds) from the source video orientationsets 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