跳轉到主要內容
GET
/
v1
/
videos
/
{video_id}
/
content
Download finished Sora video content
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id}/content \
  --header 'Authorization: Bearer <token>'
"<string>"
使用此端點可在工作達到 completed 後下載已完成的 Sora 輸出。在此之前，它會回傳錯誤，而不是影片檔案。

​
下載前須知

  • 等待 擷取影片 回報 status: completed
  • 傳入建立或 remix 步驟中的 video_id
  • 如果你需要讓檔案存活時間超過供應商的暫時傳遞視窗，請將檔案儲存在你自己的 bucket 或 CDN 中

​
下載流程

1

建立或 remix 影片

從 建立影片 或 Remix 影片 開始。
2

輪詢直到完成

使用 擷取影片 直到工作達到 completed。
3

取得二進位檔案

呼叫此端點以下載 MP4 或其他支援的資產變體。

​
暫時傳遞視窗

OpenAI 的 Videos API 使用相同的最終下載步驟。在 2026-03-12 的即時驗證期間，於完成前呼叫此端點會回傳 invalid_request_error JSON 回應，這是你在轉譯仍在進行時應預期的行為。

授權

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

路徑參數

​
video_id
string
必填

Completed video id.

查詢參數

​
variant
string

Optional content variant such as the main video, thumbnail, or spritesheet when supported by the provider.

回應

Binary video content.

The response is of type file.