影片（Video）
Grok 影片 API 規範
grok-imagine-video 與 grok-imagine-video-1.5 的調用規範。
本頁是 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。
模型一覽
| 模型 | 解析度 | 時長 | 比例 | 輸入 |
|---|---|---|---|---|
grok-imagine-video | 480P / 720P，預設 720P | 1–15 秒，預設 8 秒 | 16:9 9:16 1:1 4:3 3:4 3:2 2:3，預設 16:9 | 文字，或文字 + 1 張圖片 |
grok-imagine-video-1.5 | 480P / 720P / 1080P，預設 720P | 同上 | 同上 | 同上 |
參數
- 解析度：
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 張，會回傳 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"]
}