Grok Imagine video

支援文字生成影片、首幀和參考圖片；不支援參考影片、參考音訊或首尾幀配對。首幀和普通參考圖片語義不同，不能只按圖片數量互相替代。

模型與規格

模型	輸出時長	解析度	參考圖片模式
`grok-imagine-video`	1–15 秒	480p / 720p	目前最多 7 張，最多 10 秒
`grok-imagine-video-1.5`	1–15 秒	480p / 720p / 1080p	目前最多 7 張，預設上限 15 秒

各型號依目前模式限制執行。文件的「≥7」表示已有樣本支援至少七張，並非至少要上傳七張，也不是已公布的硬上限。PopGo 目前允許 1–7 張參考圖片。

欄位與模式

欄位	型別	規則
`model`	string	必填，使用上表公開模型 ID
`prompt`	string	必填；最多 4096 UTF-8 位元組
`seconds`	integer	整數，依模式上限；介面預設 8 秒
`resolution`	string	按型號選擇，介面預設 720p
`aspect_ratio`	string	1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3；預設 16:9；首幀模式省略
`input_reference`	object	恰好一張首幀；物件內使用 image_url
`reference_images`	object[]	主體／風格參考；物件陣列，每項使用 image_url

首幀以圖片作為畫面起點；參考圖片引導主體、風格與一致性，即使只有一張也可使用。input_reference 和 reference_images 互斥。不要使用頂層 image_url：錯誤欄位可能被忽略，仍生成和計費但未採用圖片。

來源、比例與提示詞

服務文件描述公開 URL 和完整 Data URL，也記錄過任務建立後公開圖片下載失敗。PopGo 的 Grok 預設使用 Base64：本機圖片會編碼為完整 data:image/...;base64,...；公開圖片需要先讀取再編碼，瀏覽器跨來源限制可能阻止這一步。裸 Base64、本機路徑及分享頁均不能代替圖片資料。

首幀模式省略 aspect_ratio，輸出依輸入畫面並可能由服務裁切或縮放；需確定構圖時先裁切圖片。參考圖片模式仍可指定比例。未公布任意輸入比例都能原樣保留的完整保證。

4096 是位元組上限而非字數。文件中純中文 1365 字使用 4095 位元組可通過，1366 字使用 4098 位元組失敗。混合文字應計算 UTF-8 長度，縮短後再提交。

請求範例

以下為首幀和普通參考圖片範例。YOUR_IMAGE_DATA_URL 替換為完整圖片 Data URL；文字生成影片移除全部參考欄位。

{
  "model": "YOUR_MODEL",
  "prompt": "A person turns naturally toward the camera",
  "seconds": 5,
  "resolution": "720p",
  "input_reference": { "image_url": "YOUR_IMAGE_DATA_URL" }
}

{
  "model": "YOUR_MODEL",
  "prompt": "Keep the subject and visual style consistent",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "reference_images": [{ "image_url": "YOUR_IMAGE_DATA_URL" }]
}

未知欄位與輸出音訊

HTTP 200 不能證明 seed、watermark 等未公開欄位生效。不要加入目前預設未開放的參數。generate_audio 僅控制輸出音軌，並非參考音訊輸入。未知欄位不能繞過時長或互斥規則。

錯誤與修正

錯誤或現象	處理
reference-to-video duration exceeds 10s	標準版參考圖片改為最多 10 秒
Prompt length exceeds 4096	縮短 UTF-8 位元組長度
Duration must be between 1 and 15 seconds	使用整數並遵循模式更嚴格的上限
Cannot specify both image and reference_images	僅保留首幀或參考圖片其中一套
grok_media_no_eligible_account	暫無可用容量；有限退避，避免併發建立
imagine:content-moderated	修改內容；文件曾記錄此錯誤仍有非零用量，請查 PopGo 帳單
成功但未採用圖片	檢查發出欄位、素材下載及成片；任務 ID 不能證明參考有效

保存 id 並依 queued / in_progress / completed / failed 輪詢。重試前先查原任務，逾時不等於未建立。權限、餘額及容量分別排查。完整流程見影片任務流程。

模型與規格​

欄位與模式​

來源、比例與提示詞​

請求範例​

未知欄位與輸出音訊​

錯誤與修正​