MiniMax · 视频
CF 超分NEW
📌 这是什么：CF 超分工作流：按所选比例超分输出 2K / 4K，画质更高。含 3 个取值——cf-multi-reference（多图参考）/ cf-mj（MJ 风格参考）/ cf-fl2v（首尾帧），入参分别与对应的标准工作流一致，只是清晰度档位换成 2K / 4K。
💡 什么时候用：需要更高画质（2K / 4K）成片时用。⚠ CF 工作流只接受 resolution=2K/4K（传 480P/768P/1080P 返回 400），单价也高于标准档，见定价页。
🔗 响应格式：查询响应为 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 个取值共用本页的清晰度档位（2K/4K）与计费，素材与时长按各自对应的标准工作流。
| workflow_id | 用途 | 可用素材 | 时长（秒） | 清晰度档位 |
|---|---|---|---|---|
| cf-multi-reference | 多图参考的超分版 | image_urls ≤9 · 参考视频 ≤3 · 音频 ≤3 | 4~15 | 2K / 4K |
| cf-mj | MJ 风格参考的超分版 | image_urls ≤9 · 参考视频 ≤3 · 音频 ≤3 | 4~15 | 2K / 4K |
| cf-fl2v | 首尾帧过渡的超分版 | first_image（必填）+ last_image（可选）；不接受 image_urls / 参考视频 / 音频 | 4~10 | 2K / 4K |
⚠ CF 取值都无法由素材推断，必须显式传 workflow_id；下方参数表里标注「仅 …」的字段只对该取值有效，传错会返回 400 并且不会生成。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | — | 固定 minimax-h3 |
| workflow_id | string | 必填 | 工作流，本页 3 选 1：cf-multi-reference / cf-mj / cf-fl2v。各取值用途见下方对照表；本页取值都无法由素材推断，必须显式传 |
| prompt | string | 必填 | 必填，文本描述（新引擎任何情况下都要求 prompt——图生视频/首尾帧也必须给，如「镜头缓缓推进，光线柔和」） |
| image_urls | string[] | — | 参考图 URL，最多 9 张（别名 images）。仅 cf-multi-reference / cf-mj 可用且必填；cf-fl2v 不接受 |
| first_image | string | — | 首帧关键帧图 URL（别名 first_frame_image）。仅 cf-fl2v 可用且必填 |
| last_image | string | — | 尾帧关键帧图 URL（可选，别名 last_frame_image）。仅 cf-fl2v 可用，须与 first_image 一起传，只传尾帧返回 invalid_request |
| ratio | string | — | 画面比例，8 选 1：16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9，默认 16:9（比例 × 清晰度档位共同决定输出分辨率，见介绍页尺寸对照） |
| resolution | string | — | 清晰度档位（CF 超分工作流）：2K / 4K，默认 2K（不接受 480P/768P/1080P）；单价高于标准档，见定价页 |
| duration | integer | — | 时长（秒）整数 4~15，默认 4（别名 seconds）；cf-fl2v 最长 10 秒 |
| reference_videos | string[] | — | 参考视频 URL，最多 3 条，作为运动/风格参考（别名 reference_video 单条）。仅 cf-multi-reference / cf-mj 可用 |
| audio_urls | string[] | — | 音频 URL，最多 3 条，用于音频引导（别名 reference_audios）。仅 cf-multi-reference / cf-mj 可用 |
| 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": "cf-multi-reference",
"prompt": "gentle camera push-in, soft light",
"image_urls": ["https://cdn.novapi.ai/your/frame.png"],
"ratio": "16:9",
"resolution": "2K",
"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 时返回 |