GlobalAiOpc
Grok - 创建任务
使用 Grok 模型创建视频生成任务，支持文生视频和图生视频
Grok 创建视频任务
使用 Grok 模型创建视频生成任务，支持文生视频和图生视频。
认证
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。模型介绍
支持的模型：
grok_video3：可变时长6-30秒，支持480p/720p分辨率，默认10秒 +16:9+720pgrok_video3_pro：固定10秒视频，默认按16:9+720p处理grok_video3_max：支持6 / 10 / 12 / 16 / 20 / 30秒，支持480p/720p，默认10秒 +16:9+720pgrok_video3_stable：固定10秒，仅支持720p，默认16:9
请求参数
modelbodystring必填模型名称。
可选值：
grok_video3- 可变时长6-30秒grok_video3_pro- 固定10秒grok_video3_max- 支持更多固定时长和更严格的参考图约束grok_video3_stable- 固定10秒，仅支持720p
promptbodystring必填视频生成提示词，描述所需的视频内容。
示例：
"一只猫在雨中跳舞，电影风格"durationbodyinteger视频时长（秒）。
规则说明：
grok_video3：支持6-30秒，默认10秒grok_video3_pro：固定10秒，无需设置grok_video3_max：仅支持6、10、12、16、20、30秒，默认10秒grok_video3_stable：固定10秒，可省略或传入10
aspect_ratiobodystring输出视频比例。
规则说明：
grok_video3：支持16:9、9:16、1:1、3:2、2:3，默认16:9grok_video3_pro：默认16:9grok_video3_max：仅支持16:9、9:16、1:1，默认16:9grok_video3_stable：支持16:9、9:16、3:2、2:3、1:1，默认16:9
resolutionbodystring输出分辨率。
规则说明：
grok_video3：支持480p、720p，默认720pgrok_video3_pro：默认按720p处理grok_video3_max：支持480p、720p，默认720pgrok_video3_stable：仅支持720p，可省略或传入720p
image_urlsbodyarray参考图片 URL 数组（图生视频场景）。
规则说明：
grok_video3：最多支持7张参考图片grok_video3_pro：支持参考图片grok_video3_max：最多支持5张参考图片，且必须是公网 URLgrok_video3_stable：最多支持7张参考图片，且必须是公网 URL
示例：
["https://example.com/image1.jpg", "https://example.com/image2.jpg"]响应参数
idstring视频生成任务的唯一标识符，用于后续查询任务状态。
objectstring对象类型，固定为
video。createdinteger任务创建时间戳。
modelstring创建任务时使用的模型名称。
statusstring任务状态。创建成功时固定返回
queued。errorstring错误信息。创建成功时通常为
null。参数使用说明
关键约束：
- 不传
image_urls时为文生视频 - 传入
image_urls时为图生视频 grok_video3_max的比例、时长、分辨率约束最严格，建议优先按枚举值直接传入grok_video3_stable仅接受公网可访问的参考图 URL，不支持 base64
模型对比
| 特性 | grok_video3 | grok_video3_pro | grok_video3_max | grok_video3_stable |
|---|---|---|---|---|
| 时长 | 6-30 秒，默认 10 秒 | 固定 10 秒 | 6 / 10 / 12 / 16 / 20 / 30 秒，默认 10 秒 | 固定 10 秒 |
| 比例 | 16:9 / 9:16 / 1:1 / 3:2 / 2:3 | 默认 16:9 | 16:9 / 9:16 / 1:1，默认 16:9 | 16:9 / 9:16 / 3:2 / 2:3 / 1:1，默认 16:9 |
| 清晰度 | 480p / 720p，默认 720p | 默认 720p | 480p / 720p，默认 720p | 仅 720p |
| 参考图 | 最多 7 张 | 兼容参考图输入 | 最多 5 张公网 URL | 最多 7 张公网 URL |
最佳实践：
- 创建接口返回任务对象，请保存其中的
id用于后续查询。 - 提示词尽量描述主体、动作、镜头和风格。
- 如果使用
grok_video3_max，优先使用公网可访问的高质量图片。 - 如果使用
grok_video3_stable，参考图必须是公网可访问的 URL。 - 图生视频场景下，参考图数量越多，通常排队和生成时间也会更长。