Skip to main content
GET
cURL
すでに request_id を取得している場合に、このエンドポイントを使用します。xAIジョブがまだ実行中かどうかを確認し、準備ができた時点で最終動画メタデータを返します。

まず以下のフィールドを確認

  • request_id タスクは受け付けられたものの、結果がまだ準備できていない場合
  • status xAIジョブの状態を確認します。pending の間はポーリングを続け、donefailed、または expired になったら停止します
  • progress 返される場合の完了率を確認します
  • video.url レンダリングが完了した場合

ポーリングループ

1

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

まず、 xAI動画を作成 または xAI動画編集を作成を実行してから、返された request_id をコピーします。
2

タスクが終了状態になるまでポーリングする

レスポンスが request_id のみを返す場合は、数秒待ってから再度ポーリングします。statuspending の間は続行し、donefailed、または expired になったら停止します。
3

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

xAIでは生成されたURLは一時的なものとされているため、最終的な video.url を速やかにダウンロードまたはコピーしてください。

承認

Authorization
string
header
必須

Use your CometAPI API key as the bearer value.

パスパラメータ

request_id
string
必須

The deferred request ID returned by the create or edit endpoint.

レスポンス

200 - application/json

The current Grok video task state.

request_id
string

Returned when the request is accepted but result metadata is not ready yet.

model
string

The Grok video model ID.

video
object

Generated video metadata. Present when the job has completed.

status
enum<string>

The job state. done means the video metadata is ready.

利用可能なオプション:
pending,
done,
failed,
expired
progress
integer

Completion percentage when returned.

usage
object

Additional usage metadata returned when the job is complete. Its contents can vary by model.

error

Error details when the job fails.

最終更新日 2026年8月21日