Grok 视频 · 视频生成

grok-imagine-videoNEW

📌 这是什么：Grok imagine 视频模型：支持自定义时长与多张参考图；分辨率仅 480P / 720P。

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

接口地址

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

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

请求参数

参数	类型	必填	说明
model	string	必填	固定 grok-imagine-video
prompt	string	—	视频描述
imageUrls	string[]	—	图生视频参考图，支持多张（可选）。
duration	integer	—	时长（秒），自定义 ≥1，缺省 6；直接影响计费。
resolution	string	—	仅 480p / 720p（非法值回落 480p），默认 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-imagine-video",
    "prompt": "a paper plane flying over a city",
    "duration": 6,
    "resolution": "480p",
    "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

计费与积分

按秒计费 = 每秒积分 × 时长（秒）× 用户费率。每秒积分：480P=6、720P=7。例：480P 6s = 6×6 = 36。（× 你的用户费率）。任务失败自动退回。