メインコンテンツへスキップ
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
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Sora ジョブを開始した後にこのエンドポイントを使用します。現在のジョブ状態、設定されたサイズと再生時間、そしてプロバイダーから返されたエラーを確認できます。

​
確認すべきフィールド

  • ライフサイクル状態を確認するには status
  • おおまかな進行状況のシグナルを確認するには progress
  • プロバイダーがジョブを拒否した、または失敗した場合は error
  • 一時アセットの有効期限を知る必要がある場合は、完了後の expires_at

​
完了するまでポーリングする

1

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

最初に 動画を作成 または 動画をリミックス を実行します。
2

id でポーリングする

返された id をここに渡し、ジョブが completed または failed に到達するまで確認を続けます。
3

ファイルをダウンロードする

ジョブが completed になったら、動画コンテンツを取得 に進みます。

​
CometAPI でのレスポンス形式

このステップは Sora のポーリングワークフローに非常に近い構成です。CometAPI は OpenAI スタイルのオブジェクト形式を維持しているため、最小限の変換でステータス確認を組み込めます。

承認

​
Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

パスパラメータ

​
video_id
string
必須

Video id returned by the create or remix endpoint.

レスポンス

200 - application/json

Current job state.

​
id
string
必須
​
size
string
必須
​
model
string
必須
​
object
string
必須
​
status
string
必須
​
seconds
string
必須
​
progress
integer
必須
​
created_at
integer
必須
​
error
object
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null
​
remixed_from_video_id
string | null