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。