Grok
Grok Imagine 1.5 動画生成 Preview
- Grok Imagine 1.5(grok-imagine-video-1.5-preview)モデルは、1つのモデル名でテキストから動画、画像から動画、参照画像から動画をサポートします
- モードパラメータはありません。
image_urlsの画像枚数でモードが決まります ——0枚 = テキストから動画、1枚 = 画像から動画(先頭フレームとして使用)、2-7枚 = 参照画像から動画 - 非同期処理モード、返されたタスクIDを使用して照会
- 生成された動画リンクは24時間有効です。速やかに保存してください
POST
承認
ボディ
application/json
モデル名
利用可能なオプション:
grok-imagine-video-1.5-preview 例:
"grok-imagine-video-1.5-preview"
動画説明プロンプト(必須、空にはできません)
長さ制限: 4096 文字以下
例:
"The person starts dancing"
入力画像URL(任意)。画像の枚数によって生成モードが決まります。
モードの選択:
0枚(フィールドを省略): テキストから動画、画像料金なし1枚: 画像から動画、先頭フレームとして使用2-7枚: 参照画像から動画、複数画像を融合
要件:
- 画像は最大
7枚。8枚以上は拒否されます - 画像サイズ: 1枚あたり最大
10MB - サポートされる形式: JPEG, PNG, WebP
Maximum array length:
7例:
動画の長さ(秒)、1~15秒の範囲の任意の整数
必須範囲:
1 <= x <= 15例:
6
動画の解像度、デフォルトは480p
説明:
480p: 標準解像度、これがデフォルト値です720p: 高解像度1080p: フルHD
利用可能なオプション:
480p, 720p, 1080p 例:
"480p"
タスク完了後のHTTPSコールバックURL
コールバックタイミング:
- タスクが完了、失敗、またはキャンセルされた時にトリガー
- 課金確認後に送信
セキュリティ制限:
- HTTPSプロトコルのみサポート
- 内部IPへのコールバックは禁止(127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x など)
- URLの長さは
2048文字以下
コールバックメカニズム:
- タイムアウト:
10秒 - 失敗時最大
3回リトライ(1/2/4秒後) - レスポンス形式はタスク照会APIと一致
- 2xxステータスコード = 成功、その他はリトライをトリガー
例:
"https://your-domain.com/webhooks/video-task-completed"
レスポンス
動画タスクが正常に作成されました
タスク作成タイムスタンプ
例:
1757169743
タスク ID
例:
"task-unified-1757169743-7cvnl5zw"
使用された実際のモデル名
例:
"grok-imagine-video-1.5-preview"
具体的なタスクタイプ
利用可能なオプション:
video.generation.task タスク進捗率(0-100)
必須範囲:
0 <= x <= 100例:
0
タスクステータス
利用可能なオプション:
pending, processing, completed, failed 例:
"pending"
動画タスクの詳細情報
タスク出力タイプ
利用可能なオプション:
text, image, audio, video 例:
"video"
使用量と課金情報