Grok 视频 API

知梦视频已开放两个彼此独立的 Grok 视频模型：

grok-imagine-video
grok-imagine-video-1.5

两者均使用异步任务接口。创建任务后保存返回的任务 ID，再轮询查询状态，任务完成后读取视频地址。

快速信息

项目	内容
Base URL	https://movie.zmoapi.cn
创建任务	POST /v1/videos/generations
查询任务	GET /v1/videos/{task_id}
生成时长	1–15 秒
请求格式	application/json
默认音频	开启，可通过 generate_audio: false 关闭

模型与价格

模型	480P	720P	1080P
grok-imagine-video	¥0.11 / 秒	¥0.13 / 秒	不支持
grok-imagine-video-1.5	¥0.15 / 秒	¥0.22 / 秒	¥0.34 / 秒

费用按照生成视频的实际时长计算：

订单费用 = 对应模型与分辨率单价 × 视频时长（秒）

例如 grok-imagine-video 生成 4 秒 480P 视频：

¥0.11 × 4 = ¥0.44

鉴权

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

API Key 应只保存在服务端环境变量或安全配置中，不要提交到公开仓库或暴露在浏览器代码中。

创建任务

curl 'https://movie.zmoapi.cn/v1/videos/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "grok-imagine-video",
    "prompt": "电影感镜头，一辆复古跑车穿过雨后的霓虹街道，镜头缓慢跟随",
    "duration": 4,
    "resolution": "480p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

常用字段：

字段	类型	必填	说明
model	string	是	grok-imagine-video 或 grok-imagine-video-1.5
prompt	string	是	视频生成提示词
duration	integer	是	1–15 秒
resolution	string	是	480p、720p；1.5 额外支持 1080p
aspect_ratio	string	否	1:1、16:9、9:16、4:3、3:4、3:2、2:3
generate_audio	boolean	否	是否生成音轨，默认 true
image_urls	string[]	否	公网 HTTPS 参考图片直链

分辨率

grok-imagine-video 只支持 480P 与 720P，不要向它发送 1080p。需要 1080P 时使用 grok-imagine-video-1.5。

参考图生成

参考图应先上传到公网可访问的 HTTPS 地址，再通过 image_urls 提交：

{
  "model": "grok-imagine-video-1.5",
  "prompt": "让参考图中的主体自然向前走，镜头平稳跟随",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "image_urls": [
    "https://example.com/reference-image.jpg"
  ]
}

参考图 URL 必须直接返回图片文件，不能使用本地路径、blob: 地址、网盘分享页、需要 Cookie 的页面或短时间失效的链接。当前可用参考图数量以接口实际校验结果为准。

创建响应

创建成功会立即返回异步任务信息，不会直接返回成片。任务 ID 可能位于 id、task_id 或 request_id：

{
  "id": "task_EXAMPLE",
  "task_id": "task_EXAMPLE",
  "status": "queued",
  "progress": 0
}

保存平台返回的任务 ID，后续查询必须使用它。

查询任务

curl 'https://movie.zmoapi.cn/v1/videos/task_EXAMPLE' \
  -H 'Authorization: Bearer YOUR_API_KEY'

常见状态：

状态	含义
queued / pending	排队中
in_progress / processing	生成中
completed / succeeded / done	已完成
failed / expired / cancelled	已结束且没有可用成片

建议每 10–20 秒查询一次。可以对查询 GET 的 429、网络错误和 5xx 做退避重试，但不要因为一次查询失败重新创建任务。

完成结果

任务完成后，从响应中的视频 URL 字段读取成片。平台可能同时返回以下一种或多种结构：

content.url
video.url
result_url
video_url
output[0]

示例：

{
  "id": "task_EXAMPLE",
  "status": "succeeded",
  "progress": 100,
  "video": {
    "url": "https://storage.example.com/generated-video.mp4"
  }
}

结果地址不是永久存储，任务完成后应尽快下载或转存。

接入规则

1. 两个模型是独立模型，不是清晰度档位。
2. 创建路径是 /v1/videos/generations，不要写成 /v1/videos。
3. 时长只支持 1–15 秒。
4. 基础模型不支持 1080P。
5. 参考图使用公网 HTTPS 直链，不要提交本地文件路径。
6. 创建成功后必须轮询任务，不能把 HTTP 200 当作视频已经生成。
7. 创建请求超时或断连时不要无条件自动重试，以免重复生成和重复计费。

相关页面

• 视频 API 概览
• 视频计费说明
• API 在线调试