メインコンテンツへスキップ
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 が返されるまで待ちます
  • 作成またはリミックスのステップで取得した video_id を渡します
  • プロバイダーの一時的な配信期間を超えて保持する必要がある場合は、ファイルを自身のバケットまたは CDN に保存します

​
ダウンロードの流れ

1

動画を作成またはリミックス

動画を作成 または 動画をリミックス から開始します。
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.