Grok 视频
Grok Imagine Video
使用 POST /v1/videos 调用 grok-imagine-video 提交 JSON 视频生成任务。
POST
Grok Imagine Video
grok-imagine-video 是 Grok Imagine 线路的视频生成模型。该模型使用 application/json 创建任务,适合不希望使用 multipart 上传文件的接入方。
- 接口路径是
POST /v1/videos。 - 请求格式是
application/json。 - 文生视频只需要
model、prompt、seconds、aspect_ratio、resolution。 - 图生视频单图使用
image,多图使用images。 resolution支持480P和720P,也兼容480/720。prompt最多支持4096个字符;过长或过密的提示词可能导致上游没有返回任务 ID。
方法与路径
响应示例
认证
Body
固定传
grok-imagine-video。视频生成提示词。最多
4096 个字符。目标秒数。最小为
1 秒;建议按字符串传入,例如 "6"。宽高比。支持常见预设
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,也支持 数字:数字 的自定义比例。输出清晰度。支持
480P、720P,也兼容 480、720 写法。单张参考图。使用
data:image/png;base64,... 这类 data URI。传入 image 时不要同时传 images。多张参考图。数组成员使用
data:image/png;base64,... 这类 data URI。传多张图时不要同时传 image。请求构造规则
客户端如从本地文件构造 JSON 请求,应先读取图片二进制并转为 Base64 data URI,再写入
image 或 images。不要把本地文件路径直接作为 JSON 图片字段提交。
Response
任务 ID。后续用
GET /v1/videos/{id} 查询结果。任务 ID。部分响应会同时返回
id 与 task_id,两者可指向同一个任务。对象类型,通常为
video。实际提交的模型名。
任务状态,常见值有
queued、processing、completed、failed、cancelled。任务进度百分比。
任务完成后的视频地址。也可以使用
GET /v1/videos/{task_id}/content 下载结果。错误处理建议
如果创建任务返回5xx,且错误信息包含 task_id is empty,通常表示上游没有接受本次任务。常见触发原因包括提示词过长、分镜描述过密或上游临时拒绝创建任务。建议客户端记录当前 prompt 的字符数与字节数,并在重试前压缩提示词。