跳转到主要内容
POST
/
kyyReactApiServer
/
v1
/
grok
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/grok/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok_video3",
    "prompt": "一只猫在雨中跳舞，电影风格",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "grok_video3",
  "status": "queued",
  "error": null
}

​
Grok 创建视频任务

使用 Grok 的 AI 模型创建视频生成任务，支持文生视频和图生视频模式。

​
认证

所有请求都需要在请求头中包含 Bearer token： 
Authorization: Bearer {{key}}

​
模型介绍

支持的模型：
  • grok_video3：可变时长 6-30 秒，支持 480p/720p 分辨率，按秒计费
  • grok_video3_pro：固定 10 秒，不支持指定分辨率

​
请求参数

​
model
string
必填
模型名称可选值：
  • grok_video3 - 可变时长 6-30 秒（按秒计费）
  • grok_video3_pro - 固定 10 秒
​
prompt
string
必填
视频生成提示词，描述所需的视频内容示例："一只猫在雨中跳舞，电影风格"
​
duration
integer
视频时长（秒）
  • grok_video3：支持 6-30 秒，默认 6 秒
  • grok_video3_pro：固定 10 秒（无需设置）
​
aspect_ratio
string
输出视频比例，默认为 16:9支持的值：
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 正方形
  • 3:2 - 标准横屏
  • 2:3 - 标准竖屏
​
resolution
string
输出分辨率，默认为 480p支持的值：
  • 480p - 标清（默认）
  • 720p - 高清
仅 grok_video3 支持画质选择

​
图生视频模式

​
image_urls
array
参考图片 URL 数组（图生视频场景）
  • grok_video3：最多支持 7 张参考图片
  • grok_video3_pro：支持参考图片
格式要求：jpeg、png、webp 值类型：公网 URL 数组示例：["https://example.com/image1.jpg", "https://example.com/image2.jpg"]

​
响应参数

​
id
string
视频生成任务的唯一标识符，用于后续查询任务状态
​
object
string
对象类型，固定为 video
​
created
integer
任务创建时间戳
​
model
string
使用的模型名称
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
​
error
string
错误信息，当 status 为 failed 时返回

​
使用场景

文生视频

仅使用 prompt 生成视频，无需图片引导

图生视频

使用参考图片引导视频生成，最多支持 7 张

​
Grok 特性

灵活时长

grok_video3 支持 6-30 秒可调节视频时长

多比例支持

支持 5 种常用视频比例

分辨率选择

grok_video3 支持 480p、720p 两种分辨率

多图参考

grok_video3 最多支持 7 张参考图片

​
模型对比

特性grok_video3grok_video3_pro
时长6-30 秒可调固定 10 秒
分辨率480p / 720p不支持指定
计费按秒计费按次计费
参考图片最多 7 张支持
最佳实践：
  1. 视频生成为异步处理，需要通过返回的 id 查询任务状态和结果
  2. 在提示词中明确描述所需的视觉效果和风格
  3. 选择合适的模型：
    • grok_video3：灵活时长，按秒计费，适合不同时长需求
    • grok_video3_pro：固定 10 秒，适合标准时长场景
  4. 图片 URL 必须是公网可访问的地址
  5. 合理使用参考图片数量，避免过多图片导致生成效果不佳
场景选择建议：
  • 文生视频：完全由 AI 创作，适合创意探索
  • 图生视频：基于参考图片生成，适合有明确风格或内容参考的场景
  • 多图参考：使用多张图片提供更丰富的视觉引导
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/grok/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok_video3",
    "prompt": "一只猫在雨中跳舞，电影风格",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "grok_video3",
  "status": "queued",
  "error": null
}