# MiniMax 接入说明

https://video-doc.1route.dev/zh/docs/minimax



## 当前验证状态（2026-09-23） [#当前验证状态2026-09-23]

最新并发验证中，图片与音频参考版已受理，但交付仍待确认；两个按次版提交失败，933 按秒版也提交失败。**这三个失败型号已暂停新请求，从插件公开目录和接口规范移除；历史任务与账单保留。** 当前只保留 `minimax-h3-8img3audio` 作为测试入口，不承诺稳定交付。

提交成功不代表文件已准备好，99% 或归档中不能当作可下载。提交超时也不等于确认未生成；接入程序应保留请求记录并联系支持核对，不能自动重发。

[机器可读验证记录](/minimax-test-status.json)仅描述本轮测试，不是长期可用性保证。

## 先确认型号、权限和预算 [#先确认型号权限和预算]

服务根地址为 `https://video.1route.dev`。使用本站“混合”组 API Key，先调用 `GET /v1/models`，确认所选型号在该 Key 的可用列表里。不要使用图片站的 Key。

[型号与售价](/zh/docs/minimax-models/)仅列出当前启用的 ID 和验证状态。给 AI 阅读时，同时提供 [models.json](/models.json) 和 [MiniMax OpenAPI](/minimax-openapi.json)。后者不包含暂停型号，也不代表 WAN3 或其他系列使用相同参数。

目录是公开报价快照，不代表你的 Key 有权限。`null` 上限表示尚未确认，不表示无限制；`unverified` 表示尚未验证，不能当作支持承诺。首次测试前让用户确认模型、素材用途、时长和人民币预算。

## 请求字段 [#请求字段]

`POST /v1/videos`，请求头使用 `Authorization: Bearer YOUR_API_KEY` 和 `Content-Type: application/json`。

| 字段           | 类型        | 规则                               |
| ------------ | --------- | -------------------------------- |
| `model`      | 字符串       | 完整复制本站公开 ID，不用页面展示名称             |
| `prompt`     | 非空字符串     | 描述画面，多图时按 Image 1、Image 2 指明素材用途 |
| `seconds`    | 整数        | 必填；5–15 秒                        |
| `resolution` | 字符串       | `480p` 或 `768p`，不是像素尺寸字符串        |
| `ratio`      | 字符串       | `16:9` 或 `9:16`                  |
| `images`     | URL 字符串数组 | 图片与音频参考版最多 8 张                   |
| `audios`     | URL 字符串数组 | 图片与音频参考版最多 3 段，尚未完成音频参考实测        |
| `videos`     | URL 字符串数组 | 当前型号不支持参考视频，请勿提交非空数组             |

只使用公开可访问、无需登录的 HTTP(S) 素材直链。不接受本地路径、网盘预览页或 base64。未经用户同意，不把私人素材传到第三方图床。

**不要发送 WAN3 的 `reference_images`、`reference_videos`。** 接入程序统一使用以上规范字段，不混用 `duration`、`size`、`aspect_ratio` 等兼容别名。当前最小示例带 1 张图片；不承诺无图纯文生可用。

## 最小请求示例 [#最小请求示例]

下面的素材地址是占位符，必须替换为用户授权使用的真实图片直链。不要直接运行占位符请求。

```json
{
  "model": "minimax-h3-8img3audio",
  "prompt": "Image 1 为场景参考。镜头缓慢推进，保持主体和构图连贯。",
  "seconds": 5,
  "resolution": "768p",
  "ratio": "16:9",
  "images": ["https://YOUR_MEDIA_HOST/reference.jpg"]
}
```

API Key 从私密环境变量 `VIDEO_API_KEY` 读取，不放到浏览器公开代码、截图或日志。将请求发到本站根地址加 `/v1/videos`，不要重复拼接 `/v1`。

## 创建、等待、下载 [#创建等待下载]

1. 只提交一次。收到响应后立即保存完整 `id` 和 `X-Oneapi-Request-Id`。
2. 每 15 秒 `GET /v1/videos/{id}`，使用同一 Key。`queued`、`in_progress` 继续等待。
3. `completed` 后读取 `metadata.url`（响应也可能提供 `url`）。若暂时无链接，继续查询同一个任务，不要重新生成。
4. 完整使用返回的本站下载地址，立即保存 MP4。签名链接最长约 5 分钟，缓存文件准备好后保留约 10 分钟。不要向任意下载域名转发 API Key。
5. 生成失败停止轮询并检查本站任务/用量记录。生成成功但暂不能交付视频时，联系支持处理交付或退款，不把“无链接”当作已退款。

创建超时、连接断开或 5xx 结果不明确时，**不要自动重试 POST**。先核对任务和用量记录。GET 暂时失败可退避重试。程序重启后使用保存的 ID 恢复查询；本站不承诺幂等创建或取消接口。

## 结算状态 [#结算状态]

生成状态、交付状态和结算状态是三件事。按秒模型缺少有效用量时保留预扣、待人工对账，不能把估算当成最终费用。不要按接口耗时、图片数量或 WAN3 参考视频公式计算 MiniMax 费用。详见[型号与售价](/zh/docs/minimax-models/)。