Grok 视频 · 视频生成

grok-video-3-proNEW

📌 这是什么：Grok video 3 Pro：时长固定 10 秒；支持 480P~1080P。

💡 什么时候用：要出 grok-video-3-pro 视频时用。

接口地址

用途	方法	路径
提交任务	POST	/api/cqt/generator/grok
查询结果	GET	/api/cqt/info/grok?id={taskId}

⏱ 建议轮询时间：视频为异步生成，建议每 15 秒轮询一次，直到 status = succeeded / failed。

请求参数

参数	类型	必填	说明
model	string	必填	固定 grok-video-3-pro
prompt	string	—	视频描述
imageUrls	string[]	—	可作首帧参考图（可选）。
duration	integer	—	固定 10s（传入被忽略）。
resolution	string	—	480p / 540p / 720p / 1080p，默认 480p。
aspectRatio	string	—	比例 2:3 / 3:2 / 1:1 / 16:9 / 9:16，默认 16:9
mode	string	—	fun / normal / spicy（非法值会被忽略）
nsfwChecker	boolean	—	是否启用 NSFW 检查，默认 false
callBackUrl	string	—	完成回调地址

请求示例

curl -X POST https://api.cqtai.com/api/cqt/generator/grok \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "grok-video-3-pro",
    "prompt": "a paper plane flying over a city",
    "resolution": "720p",
    "aspectRatio": "16:9"
  }'
# -> { "code":200, "data":"<taskId>" }

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "35592194e2c14f868b960061311d3955",
    "resultUrl": "https://r2.geeknow.top/videos/288/task_Vpw2drsWF6DKZQY2rpNQ8XjtUvGa2i02.mp4",
    "status": "succeeded",
    "errorMsg": null,
    "createTime": "2026-07-10 10:53:11",
    "completeTime": "2026-07-10 10:53:55"
  }
}

响应字段说明

字段	类型	说明
code	number	状态码，200 表示请求成功
msg	string	状态描述，成功为 success
data.id	string	任务 ID（taskId），用于 GET /api/cqt/info 轮询查询
data.status	string	任务状态：succeeded 成功 / failed 失败 / 其余为处理中
data.resultUrl	string	生成结果的视频地址，status = succeeded 时返回；未完成或失败为 null
data.errorMsg	string \| null	失败原因；成功时为 null
data.createTime	string	任务创建时间
data.completeTime	string \| null	任务完成时间；未完成为 null

计费与积分

按秒计费（固定 10s）= 每秒积分 × 10 × 用户费率。每秒积分：480P/540P=5、720P=6、1080P=7。例：720P = 6×10 = 60。（× 你的用户费率）。任务失败自动退回。