メインコンテンツへスキップ
GET
/
grok
/
v1
/
videos
/
{request_id}
Query an xAI video job
curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3",
    "action": "VIDEO_GENERATION",
    "status": "SUCCESS",
    "fail_reason": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
    "submit_time": 1773297002,
    "start_time": 0,
    "finish_time": 1773297014,
    "progress": "100%",
    "data": {
      "model": "grok-imagine-video",
      "usage": {
        "cost_in_usd_ticks": 500000000
      },
      "video": {
        "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
        "duration": 1,
        "respect_moderation": true
      },
      "status": "done"
    }
  }
}
このエンドポイントは、すでに request_id を取得している場合に使用します。xAI のジョブがまだ実行中かどうかを確認し、準備ができていれば最終的な動画メタデータを返します。

​
最初に確認すべきフィールド

  • トップレベルのエラー用のラッパー code と message
  • CometAPI のタスク状態を示す data.status
  • ネストされたプロバイダー状態を示す data.data.status
  • レンダリング完了時の data.data.video.url

​
ポーリングループ

1

まず動画を作成または編集する

動画生成 または 動画編集 から開始し、返された request_id をコピーします。
2

ネストされた status が done になるまでポーリングを続ける

ラッパーとネストされたプロバイダーフィールドの両方を確認し、ラッパーの失敗とプロバイダーレベルの失敗を区別できるようにします。
3

完了したファイルを保存する

最終的な video.url はすぐにダウンロードまたはコピーしてください。xAI のドキュメントでは、生成された URL は一時的なものとされています。

​
CometAPI で想定される動作

これは、xAI が公式ワークフローで説明しているものと同じポーリング手順です。CometAPI はプロバイダーのペイロードをラッパーエンベロープで包むため、プロバイダーをまたいで非同期ジョブをより一貫して処理できます。

承認

​
Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

パスパラメータ

​
request_id
string
必須

Deferred request id returned by the create or edit endpoint.

レスポンス

200 - application/json

Current task state.

​
code
string
必須
​
message
string
必須
​
data
object
必須