Skip to main content
POST
Create video generation
/v1/videos/generations を送信すると、すぐに task_id が返ります。生成時間は動画の長さと解像度によって異なり、通常は 1〜5 分です。/v1/tasks/{task_id} でタスクのステータスをポーリングしてください。
現在、動画 API は grok-imagine-video モデルのみに対応しています。推論と課金には Grok チャネルの特別価格が適用されます。

リクエスト URL

テキストから動画を生成する例

成功時のレスポンス:
task_id を取得したら、動画タスクを取得を呼び出して照会してください。

参照画像から動画を生成する例

参照画像は、先に data:image/...;base64,... 形式の Data URL に変換する必要があります。ブラウザの blob: URL は直接指定できません。サーバー側でバイナリを読み込み、エンコードしてから指定してください。

パラメータ

長さと解像度の組み合わせ

  • 720p は最終成果物に適しています。480p は生成が速く、プレビューに適しています。
  • 動画が長いほど生成時間と単価が高くなります。まずは seconds: "6" でフロー全体を確認することを推奨します。
  • 同じプロンプトを 9:16 または 1:1 に変更する場合は、被写体が切れないよう、画面内での位置を説明に含めることを推奨します。

エラー処理

動画 API も OpenAI 形式の error ラッパーを使用します。一般的なエラーについてはエラーを参照してください。参照画像に関する 400 エラーが表示された場合は、次の点を確認してください。
  • 参照画像が PNG / JPEG / WebP 形式であること。
  • Data URL を使用していること(blob: や通常の HTTP URL ではないこと)。
  • 参照画像 1 枚あたりのサイズが 10 MB 未満であること。
  • 参照画像が 7 枚以下であること。

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ボディ

application/json
model
string
デフォルト:grok-imagine-video
必須
prompt
string
必須
Maximum string length: 2500
seconds
enum<string>
必須
利用可能なオプション:
6,
10,
12,
16,
20
size
enum<string>
必須
利用可能なオプション:
1280x720,
720x1280,
1024x1024
resolution_name
enum<string>
必須
利用可能なオプション:
480p,
720p
preset
enum<string>
必須
利用可能なオプション:
normal,
fun,
spicy,
custom
input_reference
string[]
Maximum array length: 7

data:image/...;base64,... Data URL

group
string

レスポンス

Video task submission

data
object