Grok 動画 API 仕様

このページは、xAI の Grok 動画モデル grok-imagine-video、grok-imagine-video-1.5 の呼び出し仕様です。これらのモデルは、他の動画モデルと同じく POST /v1/videos で作成し、GET /v1/videos/{id} でポーリングします。認証、ポーリングのステータス、結果のダウンロード、エラー処理は動画 API 完全呼び出し仕様を参照してください。このページでは、Grok に固有のフィールドとルールだけを説明します。

2026-10-10 更新。従来の grok-imagine-video-1.5-1080p は提供を終了しました。1080P には grok-imagine-video-1.5 を使い、"resolution": "1080p" を設定してください。Grok はアスペクト比を aspect_ratio（または ratio、size）で設定します。Grok はポーリングのみに対応しています。callback_url は設定しないでください。

モデル一覧

パラメーター

• 解像度：resolution に 480p または 720p を指定します。grok-imagine-video-1.5 では 1080p も指定できます。metadata.resolution に書くこともできます。
• 長さ：duration（または文字列形式の seconds）に 1–15 の整数の秒数を指定します。
• アスペクト比：aspect_ratio と ratio は同じ意味で、size にアスペクト比を書くこともできます（例："size": "9:16"）。size はピクセルサイズを受け付けません。複数のアスペクト比フィールド（metadata 内のものを含む）を同時に指定する場合は値を一致させてください。一致しないと 400 が返ります。
• 画像：最大 1 枚で、公開 https:// URL である必要があります。images、image、input_reference のいずれかに書けます。同じ画像を 2 つのフィールドに 1 回ずつ書いた場合も 2 枚とみなされ、400 が返されます。
• プロンプト：画像を指定した場合は prompt を省略できます。どちらもない場合は 400 が返されます。
• 非対応：開始・終了フレーム、参照動画、参照音声、negative_prompt、seed、generate_audio、multipart/form-data によるファイルアップロード。

テキストから動画生成

{
  "model": "grok-imagine-video-1.5",
  "prompt": "雨の夜の街を走る銀色のスポーツカー、ローアングルの追従ショット、ネオンの映り込み、映画のような質感",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p"
}

画像から動画生成

{
  "model": "grok-imagine-video",
  "prompt": "参照画像の被写体を保ったまま、クローズアップからゆっくり引いていく。映画のような質感",
  "duration": 6,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "images": ["https://cdn.example.com/start.jpg"]
}