xAI
動画生成
CometAPI の POST /grok/v1/videos/generations を使用して Grok で動画を作成し、プロンプトで入力画像をアニメーション化し、request_id を使って結果をポーリングします。
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}このエンドポイントは、テキスト、またはテキストに1枚の元画像を加えた入力から Grok の動画ジョブを開始するために使用します。すぐに
request_id が返されるため、非同期ワークフローの最初のステップとして扱ってください。
小さなリクエストから始める
model: grok-imagine-videoを使用します- スモークテストでは、
durationは1、resolutionは480pのままにします - image-to-video を行いたい場合にのみ
image.urlを追加します - base64 を送信する場合は、ドキュメントと OpenAPI の例の形式を
data:image/png;base64,<BASE64_IMAGE_DATA>のままにしてください
タスクの流れ
完了までポーリング
ネストされた provider status が
done になるまで 動画生成結果を取得 を呼び出します。CometAPI で変わる点
xAI は動画生成を、開始 -> ポーリングの2段階フローとしてドキュメント化しています。CometAPI は同じリクエスト形式と同じコア model id を維持しますが、認証には CometAPI キーを使用し、CometAPI のベース URL を利用します。実際の 1 秒・480p のリクエストは 2026-03-12 に正常完了し、実際の結果 URL を返しました。承認
Bearer token authentication. Use your CometAPI key.
ボディ
application/json
Prompt for the video job.
例:
"A candle flickers on a wooden table."
Output aspect ratio.
利用可能なオプション:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
例:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
利用可能なオプション:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
レスポンス
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}