Sora 视频生成
通过 AceDataCloud 的 OpenAI Sora API 生成 AI 视频。
设置: 请参阅 身份验证 了解令牌设置。
快速开始
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "一只金毛猎犬在日落时分的海滩上奔跑", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}'
异步: 请参阅 异步任务轮询。通过
POST /sora/tasks并携带{"id": "..."}进行轮询。
模型
| 模型 | 时长 | 质量 | 最佳用途 |
|---|---|---|---|
sora-2 | 10–15秒 | 标准 | 大多数任务(默认) |
sora-2-pro | 10–25秒 | 更高 | 优质视频、较长视频 |
工作流
1. 文本转视频
POST /sora/videos
{
"prompt": "夜晚繁忙的东京街道,霓虹灯倒映在雨水坑中",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
2. 图像转视频
使用参考图像指导生成。
POST /sora/videos
{
"prompt": "场景逐渐以柔和的运动活跃起来",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
3. 角色驱动视频
从现有视频中提取角色,并将其用于新场景。
POST /sora/videos
{
"prompt": "角色走过一座未来城市",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
参数
| 参数 | 值 | 描述 |
|---|---|---|
model | "sora-2", "sora-2-pro" | 使用的模型(必填) |
size | "small", "large" | 视频分辨率 |
duration | 10, 15, 25 | 视频时长(秒,仅 sora-2-pro 支持25秒) |
orientation | "landscape" (16:9), "portrait" (9:16), "square" (1:1) | 视频朝向 |
version | "1.0" | API 版本 — 版本 1.0 支持最长25秒时长、朝向、角色参考和图像输入 |
注意事项
- 25秒时长仅适用于
sora-2-pro模型 size: "large"可生成更高分辨率视频,但成本更高且耗时更长- 角色驱动生成需要来自源视频的
character_start和character_end时间戳(以秒为单位) orientation设置宽高比 — 移动端内容推荐使用"portrait"- 任务状态使用
"succeeded"(而非 "completed")— 轮询时请检查此值
MCP:
pip install mcp-sora| 托管服务:https://sora.mcp.acedata.cloud/mcp| 请参阅 所有 MCP 服务器