00-概述
Grok 视频生成 · 概述
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配 Grok (xAI) 官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
能力简介
| 任务类型 | 接口路径 | 说明 |
|---|---|---|
| 文生视频 | POST /grok/v1/videos/generations | 根据文本提示词生成视频。 |
| 图生视频 | POST /grok/v1/videos/generations | 输入图片作为首帧，结合文本提示词生成视频。 |
| 参考图生视频 | POST /grok/v1/videos/generations | 通过 1-7 张参考图片引导视频生成的视觉风格（人物身份、产品外观、服装、艺术风格等），参考图不作为首帧。 |
| 视频编辑 | POST /grok/v1/videos/edits | 对已有视频进行编辑修改，如添加/替换物体、修改场景等。 |
| 视频延长 | POST /grok/v1/videos/extensions | 从已有视频的最后一帧继续生成，延长视频时长。支持链式调用，反复延长生成更长视频。 |
| 查询任务 | GET /grok/v1/videos/{request_id} | 轮询任务状态及结果 |
request_id，需通过查询接口轮询状态；任务成功后响应中包含视频下载地址（有效期 24 小时），请及时下载或转存。标准调用流程
创建任务 (POST https://studio.dataeyes.ai/grok/v1/videos/generations)
│ 返回 request_id
▼
查询状态 (GET https://studio.dataeyes.ai/grok/v1/videos/{request_id}) ← 轮询直至 done
│ 返回 video.url
▼
下载视频文件接口地址
路径规则：在平台域名后追加渠道前缀 /grok，再拼接官方原始路径即可。
例如官方https://api.x.ai/v1/videos/generations
→ 平台https://studio.dataeyes.ai/grok/v1/videos/generations
鉴权
Authorization 头携带 Bearer Token 进行鉴权：Authorization: Bearer {API_KEY}{API_KEY} 为您在平台控制台创建的接口密钥。请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API_KEY} |
Content-Type | 是 | 固定为 application/json |
模型
| 模型 | 说明 |
|---|---|
grok-imagine-video | Grok 视频生成模型，支持文生视频、图生视频、参考图生视频、视频编辑和视频延长 |
任务状态值
| 状态 | 含义 |
|---|---|
pending | 处理中 |
done | 已完成 |
failed | 失败 |
expired | 已过期 |
响应格式
request_id 用于轮询：{
"request_id": "string"
}{
"status": "done",
"video": {
"url": "string",
"duration": 10,
"respect_moderation": true
},
"model": "grok-imagine-video"
}视频下载 URL 有效期为 24 小时，请及时下载或转存。
相关文档
