MiniMax · 视频
多图参考NEW
📌 这是什么：基于一张或多张参考图（可再叠加参考视频/音频）生成视频，是默认的图生视频工作流。本页含 3 个取值——multi-reference（通用多图参考）/ multi-reference-4（多图组合参考）/ mj（MJ 风格参考），用 workflow_id 选择。
💡 什么时候用：有参考图、想让它动起来时用（最多 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。
工作流取值
以下 3 个取值共用本页的参数表、请求示例与计费，差异只在生成风格。
| workflow_id | 用途 | 可用素材 | 时长（秒） | 清晰度档位 |
|---|---|---|---|---|
| multi-reference | 通用多图参考（默认） | 图 ≤9 · 参考视频 ≤3 · 音频 ≤3 | 4~15 | 480P / 768P / 1080P |
| multi-reference-4 | 多张参考图的组合参考 | 图 ≤9 · 参考视频 ≤3 · 音频 ≤3 | 4~15 | 480P / 768P / 1080P |
| mj | MJ 风格参考（沿用参考素材的画风） | 图 ≤9 · 参考视频 ≤3 · 音频 ≤3 | 4~15 | 480P / 768P / 1080P |
⚠ multi-reference-4 与 mj 无法由素材推断，必须显式传 workflow_id；只给 image_urls 不传 workflow_id 会走 multi-reference。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | — | 固定 minimax-h3 |
| workflow_id | string | — | 工作流，本页 3 选 1：multi-reference / multi-reference-4 / mj。各取值用途见下方对照表；不传时按素材推断为 multi-reference；要用其它取值必须显式传 |
| prompt | string | 必填 | 必填，文本描述（新引擎任何情况下都要求 prompt——图生视频/首尾帧也必须给，如「镜头缓缓推进，光线柔和」） |
| 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（比例 × 清晰度档位共同决定输出分辨率，见介绍页尺寸对照） |
| resolution | string | — | 清晰度档位（大小写不敏感）：480P / 768P / 1080P，默认 1080P；单价随档位分档，见定价页 |
| duration | integer | — | 时长（秒）整数 4~15，默认 4（别名 seconds） |
| reference_videos | string[] | — | 参考视频 URL，最多 3 条，作为运动/风格参考（别名 reference_video 单条 / video_urls / videos） |
| audio_urls | string[] | — | 音频 URL，最多 3 条，用于音频引导（别名 reference_audios） |
| prompt_enhance | boolean | — | 提示词增强（可选，布尔）；不传用默认（开启） |
请求示例
curl -X POST https://api.cqtai.com/v1/videos \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"model": "minimax-h3",
"workflow_id": "multi-reference",
"prompt": "gentle camera push-in, soft light",
"image_urls": ["https://cdn.novapi.ai/your/frame.png"],
"ratio": "9:16",
"resolution": "1080P",
"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 时返回 |