Skip to main content
POST

Grok Imagine Video

grok-imagine-video 是 Grok Imagine 系列的视频生成模型。该模型使用 JSON 请求体,支持文生视频和参考图视频生成。
  • 接口路径是 POST /v1/videos。
  • 请求格式是 application/json。
  • 文生视频只需要 model、prompt、seconds、aspect_ratio、resolution。
  • 图生视频单图使用 image,多图使用 images。
  • resolution 支持 480P 和 720P。
  • prompt 最多支持 4096 个字符。

方法与路径

响应示例

认证

Body

string
必填
固定传 grok-imagine-video。
string
必填
视频生成提示词。最多 4096 个字符。
string
目标秒数。最小为 1 秒;建议按字符串传入,例如 "6"。
string
宽高比。支持常见预设 1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2、19.5:9、9:19.5、20:9、9:20,也支持 数字:数字 的自定义比例。
string
输出清晰度。支持 480P、720P,也兼容 480、720 写法。
string
单张参考图。使用 data:image/png;base64,... 这类 data URI。
array<string>
多张参考图。数组成员使用 data:image/png;base64,... 这类 data URI。传多张图时不要同时传 image。

Response

string
任务 ID。后续用 GET /v1/videos/{id} 查询结果。
string
对象类型,通常为 video。
string
实际提交的模型名。
string
任务状态,常见值有 queued、processing、completed、failed、cancelled。
integer
任务进度百分比。
string
任务完成后的视频地址。也可以使用 GET /v1/videos/{task_id}/content 下载结果。

与 Grok 1.5 / 3 的区别

相关接口