擷取影片內容

透過 CometAPI 中的 GET /v1/videos//content 取得已生成的 Sora 2 影片二進位資料，以便依據 video_id 下載已完成的影片輸出。

GET /v1/videos/{video_id}/content

Download finished Sora video content

cURL

curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id}/content \
  --header 'Authorization: Bearer <token>'

200

"<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.

回應

200

video/mp4

Binary video content.

The response is of type file.