Grok
涵盖标准、Fast 与 Lite 的文字和图片视频生成接口。
本系列支持的端点
- Grok创建
POST https://zexapi.com/v1/videos
https://zexapi.com/v1/videos鉴权 Authorization: Bearer YOUR_API_KEY
使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。
Grok 视频生成接口文档
接口地址
POST /v1/videos功能说明
当前可用模型与能力
| 模型名 | 文生视频 | 首帧/首尾帧 | 多参考图 | 时长说明 |
|---|---|---|---|---|
grok-imagine-video-1.5 | 支持 | 支持首帧和首尾帧 | 最多 7 张图片 | 4~15 秒 |
grok-imagine-video-1.5-fast | 支持 | 支持首帧,最长 15 秒 | 支持;多图模式最长 10 秒 | 4~15 秒,受模式限制 |
grok-imagine-video-1.5-lite | 支持 | 支持首帧,最长 15 秒 | 不支持多图 | 4~15 秒,受模式限制 |
fast和lite的首帧模式只传 1 张图片并设置first_last_frame: true。标准版传 2 张图片时可作为首尾帧。Lite 不支持多图输入。
模式判定
| 模式 | 传参方式 |
|---|---|
| 文生视频 | 不传 images,也可传空数组 [] |
| 首帧 | images 传 1 张图片,并传 first_last_frame: true |
| 首尾帧 | 仅标准版支持;images 依次传首帧、尾帧,并传 first_last_frame: true |
| 参考模式 | 传入参考素材,且不传 first_last_frame 或传 false |
first_last_frame 只决定图片是首/尾帧还是普通参考图:true:首帧或首尾帧模式;第 1 张图是首帧,第 2 张图是尾帧。false 或不传:参考模式;图片按传入顺序作为参考内容。请求方式
| 方式 | Content-Type | 参考素材字段 |
|---|---|---|
| JSON | application/json | 图片使用 images |
| 表单 | multipart/form-data | 本地图片或图片 URL 使用可重复的 input_reference 字段 |
Grok 接口只接收图片参考内容。不要把 Markdown 链接(例如 [图片](https://...))原样写入数组,只填写实际的https://...图片直链。
请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json 或 multipart/form-data,须与请求体一致 |
JSON 请求体说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | Grok 模型名称,见上方模型表 |
| prompt | string | 是 | 视频生成提示词 |
| images | string[] | 否 | 图片 URL 或完整 Base64 data URI;文生视频不传或传 [] |
| aspect_ratio | string | 否 | 视频宽高比,例如 16:9、9:16、21:9 |
| resolution | string | 否 | 输出分辨率,例如 720p;可用值以模型服务端配置为准 |
| seconds | string | 是 | 输出时长,字符串形式,如 "9";范围 4~15 |
| first_last_frame | boolean | 否 | true 表示首帧/首尾帧模式;不传或 false 表示参考模式 |
参考素材格式
{
"images": [
"https://example.com/ref.png"
]
}表单字段说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | Grok 模型名称 |
| prompt | string | 是 | 视频生成提示词 |
| input_reference | 可重复字段 | 否 | 本地图片、图片公网直链或图片 Base64;每张图片重复传一次 |
| aspect_ratio | string | 否 | 视频宽高比 |
| resolution | string | 否 | 输出分辨率,可用值以服务端配置为准 |
| seconds | string | 是 | 输出时 长,范围 4~15 |
| first_last_frame | boolean/string | 否 | true 为首帧/首尾帧模式;不传或 false 为参考模式 |
input_reference 的传法
| 方式 | 示例 |
|---|---|
| 本地文件 | -F "input_reference=@/path/to/ref.jpg" |
| 公网 URL | -F "input_reference=https://example.com/ref.jpg" |
| 图片 Base64 | -F "input_reference=data:image/jpeg;base64,/9j/..." |
请求示例
文生视频(JSON)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5",
"prompt": "一支具有电影质感的未来科技产品广告",
"aspect_ratio": "16:9",
"resolution": "720p",
"seconds": "9"
}'标准版首尾帧(JSON)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5",
"prompt": "让两个画面之间自然、连贯地过渡",
"images": [
"https://example.com/first.webp",
"https://example.com/last.webp"
],
"aspect_ratio": "21:9",
"resolution": "720p",
"seconds": "9",
"first_last_frame": true
}'标准版多参考图(JSON,最多 7 张)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5",
"prompt": "参考产品、场景和人物形象制作一支广告",
"images": [
"https://example.com/product.png",
"https://example.com/scene.png",
"https://example.com/person.png"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"seconds": "12"
}'Fast 首帧视频(JSON,最长 15 秒)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5-fast",
"prompt": "从首帧开始,镜头缓慢推进,产品表面出现流动高光",
"images": [
"https://example.com/first.png"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"seconds": "15",
"first_last_frame": true
}'Fast 多图参考(JSON,最长 10 秒)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5-fast",
"prompt": "综合参考图中的产品和场景生成广告",
"images": [
"https://example.com/product.png",
"https://example.com/scene.png"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"seconds": "10",
"first_last_frame": false
}'Lite 首帧视频(JSON,最长 15 秒)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5-lite",
"prompt": "人物从静止逐渐转身并看向镜头",
"images": [
"https://example.com/first.png"
],
"aspect_ratio": "9:16",
"resolution": "720p",
"seconds": "15",
"first_last_frame": true
}'本地图片(表单)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=grok-imagine-video-1.5" \
-F "prompt=参考这些图片制作广告" \
-F "input_reference=@/path/to/product.png" \
-F "input_reference=@/path/to/scene.png" \
-F "aspect_ratio=16:9" \
-F "resolution=720p" \
-F "seconds=10"响应参数
任务处理中
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "grok-imagine-video-1.5",
"status": "in_progress",
"progress": 10,
"created_at": 1791320000
}url 和 video_url,两者值相同。| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 任务 ID |
| object | string | 固定值 video |
| model | string | 实际使用的模型名称 |
| status | string | queued、in_progress、completed 或 failed |
| progress | number | 任务进度,0~100 |
| created_at | number | 创建时间戳(秒) |
| completed_at | number | 完成时间戳(秒,仅完成态) |
| url | string | 生成视频直链(仅完成态) |
| video_url | string | 与 url 同值(仅完成态) |
| error | object | 失败信息,通常包含 code、message |
提交成功
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "grok-imagine-video-1.5",
"status": "queued",
"progress": 0,
"created_at": 1791320000
}任务完成
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "grok-imagine-video-1.5",
"status": "completed",
"progress": 100,
"created_at": 1791320000,
"completed_at": 1791320060,
"url": "https://example.com/output.mp4",
"video_url": "https://example.com/output.mp4"
}任务失败
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "grok-imagine-video-1.5",
"status": "failed",
"progress": 0,
"created_at": 1791320000,
"error": {
"code": "invalid_request",
"message": "请求参数不符合模型能力限制"
}
}查询任务状态
GET /v1/videos/{task_id}curl -X GET "https://xxxxx.com/v1/videos/task_xxxxxxxxxxxxx" \
-H "Authorization: Bearer YOUR_API_KEY"queued / in_progress 时继续轮询;completed 时读取顶层 url 或 video_url;failed 时读取 error.message。注意事项
seconds 必须使用字符串,支持 "4"~"15"。fast 多图参考模式最长 10 秒;首帧模式可到 15 秒。lite 仅支持文生视频或单张首帧图生视频,不支持多图输入和尾帧模式。first_last_frame: true;不传或传 false 会按普通参考模式处理。images,表单使用可重复的 input_reference。multipart/form-data。接口地址
POST /v1/videos
视频调试参数说明
先选择生成方式,再选择型号。参考图片与首尾帧为独立用法,切换用法后显示对应素材输入。JSON 使用 images 数组;表单使用重复的 input_reference 文件字段。
请求示例:文生视频(表单上传)
curl --request POST 'https://zexapi.com/v1/videos' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form-string 'model=grok-imagine-video-1.5' \
--form-string 'prompt=生成自然连贯的视频' \
--form-string 'seconds=10'请求示例:首帧 / 首尾帧(表单上传)
curl --request POST 'https://zexapi.com/v1/videos' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form-string 'model=grok-imagine-video-1.5' \
--form-string 'prompt=生成自然连贯的视频' \
--form-string 'seconds=10' \
--form-string 'first_last_frame=true' \
--form 'input_reference=@/path/to/reference.png'让你的 AI 帮你接入
适用于能接收文字或读取文件的 Codex、Claude Code、WorkBuddy、AI 编辑器等。复制或下载当前接口资料,再交给你使用的 AI 工具完成接入。
真实调用需要令牌(API Key)。它是使用你账户额度的凭证,请勿粘贴到 AI 对话或公开分享。这里仅导出说明,AI 会指导你到配置位置自行填写。
第一次使用?令牌是什么,在哪里填写?
- 先获取令牌。登录你购买或开通接口的服务平台,在“令牌 / API Key / 密钥”页面创建;找不到入口时联系服务提供方。文档中的
YOUR_API_KEY是示例占位符。 - 把资料交给 AI,不要附上真实令牌。AI 会结合你的工具或项目,说明具体配置位置。工具支持专用凭据设置时优先在那里填写;其他情况按指引在本地或服务器配置,避免提交或公开。
- 配置后才能真实调用。只发文档不代表 AI 已获得调用权限或令牌。无法安全配置时,可以先使用示例响应验证,或在“接口文档”的调试台中自行测试。
本地文件和环境变量也可能被有读取权限的 AI 工具访问。如果你要求令牌不进入 AI 对话上下文,需要使用能隔离凭据并代为发送请求的可信工具,不能仅靠这份文档保证。
如果已经泄露,请到签发平台撤销旧令牌并重新生成;只删除聊天消息不够。
资料拿到后,怎么交给 AI?
第一次使用,选“复制给 AI”或“下载 Markdown 资料”其中一种即可,不需要同时操作,也不必安装 Skill。
方式一:复制给 AI(推荐)
- 点击上方“复制给 AI”,复制的是当前接口的接入资料。
- 打开你正在使用的 AI 工具,把资料粘贴到对话输入框中。
- 在资料后面补充你的需求,再发送。如果要修改已有项目,先在工具中打开项目,或提供相关文件。
方式二:下载 Markdown 资料
- 点击“下载 Markdown 资料”,得到一个
.md文件。它是文字资料,不需要运行。 - 在 AI 对话中把这个文件作为附件上传;如果使用能读取项目文件的 AI 工具,也可以把文件放到项目中,并告诉 AI 文件名和位置。
- 发送你的需求,并明确让 AI 先阅读这份资料。如果工具不能读取文件,用文本编辑器打开文件,将全部内容复制到对话中即可。
不知道怎么描述?把资料粘贴或添加文件后,可以接着这样说,并把括号里的内容换成自己的需求:
请先阅读我提供的接口资料,帮我实现【图片生成 / 视频生成等功能】,用于【我的项目或使用场景】。我不熟悉代码,请一步步说明。需要 API 令牌时,告诉我在哪里自行填写,不要让我把真实令牌发到对话里。先使用模拟数据验证,真实调用前告诉我可能产生的费用。
如果 AI 只能聊天,它可以提供步骤和代码;修改项目或执行请求,需要你使用的工具具备相应能力并获得你的授权。这里只提供资料,不会代你调用接口。文档更新后,请重新复制或下载最新资料。
反复接入时,怎样使用 Skill 包?(进阶,可跳过)
Skill 是让 AI 重复使用的一份工作说明,适合经常接入或维护接口的用户。首次使用直接复制资料或下载 Markdown 就够了。
- 点击“下载 Skill 包(进阶)”,解压 ZIP 文件,先阅读包内的
README.md。 - 如果你的工具支持 Skills,按该工具的说明导入完整的
api-integration-assistant目录,保留SKILL.md与references/integration.md的目录关系;不要只上传 ZIP 就默认已经安装成功。 - 在工具中确认技能已识别,再让 AI 使用这份技能,并说明你的接入需求。不同工具的安装方式和启用方式可能不同。
不确定工具是否支持?无需安装,直接把包内的 references/integration.md 交给 AI,使用方法与 Markdown 资料相同。包内不含执行脚本、用户令牌或上传素材,请勿覆盖已有项目指导文件。资料为固定版本 27,未明确的接口能力需要向服务提供方确认。
资料范围:当前页面可见文档。不会附带你在调试台填写的密钥或上传素材。普通开发者也可以直接使用完整接口文档。