Skip to main content
POST

Grok Imagine 1.5 Preview

grok-imagine-video-1.5-preview 是 Grok Imagine 线路的 1.5 Preview 模型。本模型使用 application/json 请求体,参考图通过 JSON 字段传递。
  • 接口路径是 POST /v1/videos
  • 请求格式是 application/json
  • 文生视频只需要 modelpromptsecondsaspect_ratioresolution
  • 图生视频使用单张 image
  • 当前 1.5 Preview 规范仅支持 1 张参考图;不要传多图 images 数组。
  • resolution 支持 480P720P,也兼容 480 / 720
  • prompt 最多支持 4096 个字符;过长或过密的提示词可能导致上游没有返回任务 ID。

方法与路径

响应示例

认证

Body

model
string
required
固定传 grok-imagine-video-1.5-preview
prompt
string
required
视频生成提示词。最多 4096 个字符。
seconds
string
目标秒数。最小为 1 秒;建议按字符串传入,例如 "6"
aspect_ratio
string
宽高比。支持常见预设 1:116:99:164:33:43:22:32:11:219.5:99:19.520:99:20,也支持 数字:数字 的自定义比例。
resolution
string
输出清晰度。支持 480P720P,也兼容 480720 写法。
image
string
单张参考图。使用 data:image/png;base64,... 这类 data URI。
images
array<string>
不建议使用。当前 grok-imagine-video-1.5-preview 规范仅接受 1 张参考图,客户端应使用 image 字段。

请求构造规则

客户端如从本地文件构造 JSON 请求,应先读取图片二进制并转为 Base64 data URI,再写入 image。不要把本地文件路径直接作为 JSON 图片字段提交。

Response

id
string
任务 ID。后续用 GET /v1/videos/{id} 查询结果。
task_id
string
任务 ID。部分响应会同时返回 idtask_id,两者可指向同一个任务。
object
string
对象类型,通常为 video
model
string
任务对应的模型名。该字段用于展示和排查,不应用作任务 ID。
status
string
任务状态,常见值有 queuedprocessingcompletedfailedcancelled
progress
integer
任务进度百分比。
video_url
string
任务完成后的视频地址。也可以使用 GET /v1/videos/{task_id}/content 下载结果。

错误处理建议

如果创建任务返回 5xx,且错误信息包含 task_id is empty,通常表示上游没有接受本次任务。常见触发原因包括提示词过长、分镜描述过密或上游临时拒绝创建任务。建议客户端记录当前 prompt 的字符数与字节数,并在重试前压缩提示词。

相关接口