Skip to main content

你將建置的內容

你將提交一個 Sora 2 影片工作、儲存回傳的影片 ID、輪詢直到工作完成,並下載已完成的影片內容。

先決條件

  • 儲存在 COMETAPI_KEY 中的 CometAPI API key
  • Python 3.10+ 與 requests,或 Node.js 18+
  • 用於輪詢的伺服器端 worker 或工作佇列

API key、基底 URL、驗證

使用以下端點建立 Sora 工作:
使用以下端點輪詢狀態:
使用以下端點下載已完成的內容:
使用 Bearer token 進行驗證:

程式碼範例

使用下方分頁查看可複製的 cURL、Python 和 Node.js 範例。

流程說明

Sora 生成是非同步的。建立端點會回傳影片 ID 和初始狀態。輪詢 GET /v1/videos/<video_id>,直到 status 變成 completedfailed。當工作完成後,使用 GET /v1/videos/<video_id>/content 下載檔案。 請使用精確的 WxH 尺寸。Sora API 參考文件記載了標準橫向與直向尺寸,以及供 Pro model 工作流程使用的更大 Pro 尺寸。

常用參數

疑難排解 / FAQ

請使用 multipart form data。參考文件中的 Sora 建立請求使用表單欄位,而非 JSON request body。
僅在狀態端點回報 completed 後再下載內容。請將完成的檔案儲存在你自己的儲存空間中。
僅在 Pro model 工作流程中使用較大的 Pro 尺寸。第一次請求請先從 1280x720 開始。

後續步驟