MiniMax · 视频

图生视频NEW

📌 这是什么：基于参考图生成动起来的视频。

💡 什么时候用：有参考图、想让它动起来时用（最多 9 张）。

🔗 响应格式：查询响应为 OpenAI 视频任务格式：顶层字段结构（不套 {code,msg,data} 壳），状态小写 queued / running / success / failed，成功返回 video_url，失败返回 {"error":{"code","message"}}；video_url 为我方 CDN 直链，可直接下载/播放。

接口地址

用途	方法	路径
提交任务	POST	/v1/videos
查询结果	GET	/v1/videos/{taskId}

⏱ 建议轮询时间：建议每 5 秒轮询一次 GET /v1/videos/{taskId}，直到 status = success / failed。

请求参数

参数	类型	必填	说明
model	string	—	固定 minimax-h3
prompt	string	必填	必填：图生视频也必须给一句描述（新引擎要求，如「镜头缓缓推进，光线柔和」）
image_urls	string[]	必填	参考图 URL，最多 9 张（别名 images）
ratio	string	—	画面比例，8 选 1：16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9，默认 16:9（各比例对应固定分辨率，见介绍页尺寸对照；清晰度自动匹配、不额外收费）
duration	integer	—	时长（秒）整数 4~15，默认 4（别名 seconds）

请求示例

curl -X POST https://api.cqtai.com/v1/videos \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "minimax-h3",
    "prompt": "gentle camera push-in, soft light",
    "image_urls": ["https://cdn.novapi.ai/your/frame.png"],
    "ratio": "9:16",
    "duration": 8
  }'
# -> 创建响应: { "id":"<task_id>", "task_id":"<task_id>", "object":"video", "model":"minimax-h3", "status":"PROCESSING", "progress":0 }

响应示例

{
  "id": "b976d0f8c1ed4c1c8ef006ea22161bcc",
  "task_id": "b976d0f8c1ed4c1c8ef006ea22161bcc",
  "object": "video",
  "model": "minimax-h3",
  "status": "success",
  "progress": 100,
  "video_url": "https://cdn.novapi.ai/minimax/1786516943631_d6ddaeaa68a4464f9e16938f16b9534b.mp4"
}

响应字段说明

字段	类型	说明
id	string	任务 ID（不透明串），与 task_id 相同，用于 GET /v1/videos/{task_id} 轮询
task_id	string	任务 ID（不透明串），提交响应返回、用于轮询查询
object	string	对象类型，固定 "video"
model	string	模型名，固定 "minimax-h3"
status	string	任务状态（小写）：queued 已排队 / running 生成中 / success 成功 / failed 失败
progress	number	进度 0~100
video_url	string	生成结果视频地址（我方 CDN 直链），status = success 时返回
error	object	失败信息 {"code","message"}，status = failed 时返回

计费与积分

15 积分 × 时长（秒），4~15s（× 你的用户费率）。任务失败自动退回。