Skip to main content
POST
Create video generation
/v1/videos/generations 提交后立即返回 task_id。生成耗时取决于时长与清晰度(一般 1 到 5 分钟),用 /v1/tasks/{task_id} 轮询任务状态。
视频接口当前只支持 grok-imagine-video 模型;推理与计费会带上 Grok 渠道的特别价格。

请求地址

文生视频示例

成功响应:
拿到 task_id 后调用 Retrieve video task 查询。

参考图生视频示例

参考图必须先转成 data:image/...;base64,... Data URL;浏览器侧的 blob: URL 不能直接传,需要先在服务端读到二进制再编码。

参数

时长与清晰度组合

  • 720p 适合最终成片;480p 出图更快,适合预览。
  • 时长越长,生成耗时和单价越高,建议先用 seconds: "6" 走通链路。
  • 同一段提示语切到 9:161:1 时,建议在描述里说明主体在画面内的位置,避免被裁掉。

错误处理

视频接口同样使用 OpenAI 风格的 error 包装,常见错误见 Errors。如果 400 提示参考图问题,请检查:
  • 参考图是否是 PNG / JPEG / WebP;
  • 是否使用了 Data URL(不是 blob: 也不是普通 HTTP URL);
  • 单张参考图小于 10 MB;
  • 参考图数量不超过 7 张。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
string
默认值:grok-imagine-video
必填
prompt
string
必填
Maximum string length: 2500
seconds
enum<string>
必填
可用选项:
6,
10,
12,
16,
20
size
enum<string>
必填
可用选项:
1280x720,
720x1280,
1024x1024
resolution_name
enum<string>
必填
可用选项:
480p,
720p
preset
enum<string>
必填
可用选项:
normal,
fun,
spicy,
custom
input_reference
string[]
Maximum array length: 7

data:image/...;base64,... Data URL

group
string

响应

Video task submission

data
object