公式API
動画を取得
CometAPI の GET /v1/videos/ を使用して、Sora 2 の動画ステータス、進行状況、再生時間、解像度、タイムスタンプ、有効期限などのメタデータを取得します。
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}Sora ジョブを開始した後にこのエンドポイントを使用します。現在のジョブ状態、設定されたサイズと再生時間、そしてプロバイダーから返されたエラーを確認できます。
確認すべきフィールド
- ライフサイクル状態を確認するには
status - おおまかな進行状況のシグナルを確認するには
progress - プロバイダーがジョブを拒否した、または失敗した場合は
error - 一時アセットの有効期限を知る必要がある場合は、完了後の
expires_at
完了するまでポーリングする
ファイルをダウンロードする
ジョブが
completed になったら、動画コンテンツを取得 に進みます。CometAPI でのレスポンス形式
このステップは Sora のポーリングワークフローに非常に近い構成です。CometAPI は OpenAI スタイルのオブジェクト形式を維持しているため、最小限の変換でステータス確認を組み込めます。承認
Bearer token authentication. Use your CometAPI key.
パスパラメータ
Video id returned by the create or remix endpoint.
⌘I
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}