你將建置的內容
你將提交一個 Sora 2 影片工作、儲存回傳的影片 ID、輪詢直到工作完成,並下載已完成的影片內容。先決條件
- 儲存在
COMETAPI_KEY中的 CometAPI API key - Python 3.10+ 與
requests,或 Node.js 18+ - 用於輪詢的伺服器端 worker 或工作佇列
API key、基底 URL、驗證
使用以下端點建立 Sora 工作:程式碼範例
使用下方分頁查看可複製的 cURL、Python 和 Node.js 範例。流程說明
Sora 生成是非同步的。建立端點會回傳影片 ID 和初始狀態。輪詢GET /v1/videos/<video_id>,直到 status 變成 completed 或 failed。當工作完成後,使用 GET /v1/videos/<video_id>/content 下載檔案。
請使用精確的 WxH 尺寸。Sora API 參考文件記載了標準橫向與直向尺寸,以及供 Pro model 工作流程使用的更大 Pro 尺寸。
常用參數
疑難排解 / FAQ
建立請求失敗
建立請求失敗
請使用 multipart form data。參考文件中的 Sora 建立請求使用表單欄位,而非 JSON request body。
內容下載失敗
內容下載失敗
僅在狀態端點回報
completed 後再下載內容。請將完成的檔案儲存在你自己的儲存空間中。Pro 尺寸無法使用
Pro 尺寸無法使用
僅在 Pro model 工作流程中使用較大的 Pro 尺寸。第一次請求請先從
1280x720 開始。後續步驟
- 閱讀建立 Sora 2 影片 API 參考。
- 使用取得 Sora 2 影片進行輪詢。
- 使用取得 Sora 2 影片內容下載。
- 在Models中查看可用的影片模型。
- 參閱對影片生成使用輪詢與 webhook。
- 透過在呼叫模型前估算請求成本估算任務成本。