HopBase 文檔Grok Imagine 視頻
grok-imagine-video-1.5——文生視頻加可選參考圖,按成片秒計費,與 Seedance 共用同一套非同步任務 API。
grok-imagine-video-1.5 是 xAI 的視頻模型，走與 Seedance 相同的異步任務 API，但請求契約是另一套。它是文生視頻加可選參考圖：沒有首尾幀，不接受參考視頻與參考音頻，也不走素材庫。該模型由 Grok 視頻分組提供,密鑰綁定了該分組即可調用。
參數
| 參數 | 說明 |
|---|---|
model | grok-imagine-video-1.5（必填，精確匹配） |
prompt 或 content | 二者必須有一個。content 只接受 text 元素，出現 image_url、video_url、audio_url 會在提交期被拒 |
resolution | 必填，這一點與 Seedance 不同。可選 480p、720p、1080p，沒有 4K 檔 |
duration | 可選，1-15 秒的整數。不接受 -1（自動）。省略時 HopBase 不下發該字段，由上游默認值決定 |
aspect_ratio | 可選：1:1、16:9、9:16、4:3、3:4、3:2、2:3。注意字段名——Seedance 的 ratio 在這裡會被拒絕，且不支持 21:9 與 adaptive |
reference_images | 可選，頂層數組，元素形如 { "url": "https://..." }。URL 必須是公網可直達的 http(s)；不接受 data: base64，也不接受 asset:// 素材 ID |
generate_audio、watermark、return_last_frame、frames、seed、camera_fixed、draft 會在提交期直接報錯，而不是被靜默丟棄——避免出現"參數看起來生效了、其實沒生效"的情況。
curl https://api.hop-base.com/v1/video/generate \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5",
"prompt": "一隻橘貓奔跑穿過陽光下的草地，鏡頭跟隨",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'拿到任務 ID 後按 Seedance 同樣的方式輪詢 GET /v1/video/tasks/{task_id}。status 取值為 pending、processing、completed、failed，非終態一律按進行中處理。完成的任務返回 duration_seconds 與 outputs 中的 HopBase 中繼地址。Grok 任務不回傳 token 用量，也不會返回 last_frame_url。
分組與相關文件
影片由 Grok 視頻分組提供,與提供對話和生圖的 Grok 全系分組是兩個分組,密鑰不通用。Grok 的對話、推理與生圖模型——含長上下文加價、推理 Token 計費與服務端工具收費——見 Grok。