Grok 视频 API 规范

本页是 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。

模型一览

参数

• 分辨率：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"]
}