MiniMax 接入说明

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

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

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

机器可读验证记录仅描述本轮测试，不是长期可用性保证。

先确认型号、权限和预算

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

型号与售价仅列出当前启用的 ID 和验证状态。给 AI 阅读时，同时提供 models.json 和 MiniMax OpenAPI。后者不包含暂停型号，也不代表 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 张图片；不承诺无图纯文生可用。

最小请求示例

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

{
  "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。

创建、等待、下载

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

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

结算状态

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