Sora 影片生成
透過 AceDataCloud 的 OpenAI Sora API 生成 AI 影片。
設定: 請參閱 驗證 以了解 Token 設定。
快速開始
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 伺服器