Create video generation
動画 / grok-imagine-video
動画生成を作成
grok-imagine-video で 6〜20 秒の短い動画を生成します。テキストと参照画像の 2 つのモードに対応しています。
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 は直接指定できません。サーバー側でバイナリを読み込み、エンコードしてから指定してください。
パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | はい | 現在は grok-imagine-video 固定です。 |
prompt | string | はい | 動画内容の説明。最大 2500 文字。 |
seconds | string | はい | 長さ。"6" / "10" / "12" / "16" / "20" から選択し、単位は秒です。 |
size | string | はい | フレームサイズ:1280x720(16:9)、720x1280(9:16)、1024x1024(1:1)。 |
resolution_name | string | はい | 解像度プラン:720p(HD)または 480p(SD)。 |
preset | string | はい | スタイルプリセット:normal(標準)、fun(楽しさを強調)、spicy(高強度)、custom(カスタムプロンプト)。 |
input_reference | string[] | いいえ | 参照画像の Data URL 配列。最大 7 枚。指定すると参照画像から動画を生成するモードになります。 |
group | string | いいえ | チャネルグループ。コンソールからの呼び出しでは default が指定されます。サードパーティーからの呼び出しでは通常、空のままにします。 |
長さと解像度の組み合わせ
720pは最終成果物に適しています。480pは生成が速く、プレビューに適しています。- 動画が長いほど生成時間と単価が高くなります。まずは
seconds: "6"でフロー全体を確認することを推奨します。 - 同じプロンプトを
9:16または1:1に変更する場合は、被写体が切れないよう、画面内での位置を説明に含めることを推奨します。
エラー処理
動画 API も OpenAI 形式のerror ラッパーを使用します。一般的なエラーについてはエラーを参照してください。参照画像に関する 400 エラーが表示された場合は、次の点を確認してください。
- 参照画像が PNG / JPEG / WebP 形式であること。
- Data URL を使用していること(
blob:や通常の HTTP URL ではないこと)。 - 参照画像 1 枚あたりのサイズが 10 MB 未満であること。
- 参照画像が 7 枚以下であること。
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ボディ
application/json
Maximum string length:
2500利用可能なオプション:
6, 10, 12, 16, 20 利用可能なオプション:
1280x720, 720x1280, 1024x1024 利用可能なオプション:
480p, 720p 利用可能なオプション:
normal, fun, spicy, custom Maximum array length:
7data:image/...;base64,... Data URL
レスポンス
Video task submission