MiniMax-H3（海螺 Hailuo-03）是 MiniMax 的多模态视频生成模型，能同时理解文本、图片、视频与音频输入，支持文生视频、图生视频、首尾帧、多模态参考生成，并提供提示增强（Context-IR）与视频再生（768P → 2K）两项进阶能力。LoopRouter 以与 MiniMax 官方完全一致的原生 /v2 接口对外透传：官方示例代码只需把 Base URL 换成 https://api.looprouter.com、把 Authorization 换成 LoopRouter 令牌即可运行。
本接口族的路径、请求体与响应体与 MiniMax 官方保持一致（/v2/video_generation 等，没有 /api 前缀）。与豆包 Seedance 的 /api/v3/... 接口是两套独立的 API，不要混用。

​
快速入口

视频生成 API

创建 / 查询 / 列表 / 删除，以及提示增强与视频再生

在线调试（试一试）

在文档内直接对 /v2 接口发起真实请求

获取 API Key

在控制台创建 sk- 令牌

​
核心特性

多模态输入

文本、图片、视频、音频自由组合，支持首尾帧与参考生成

提示增强 Context-IR

/v2/h3_context_ir 理解多模态上下文，输出结构化增强提示词

视频再生 2K

/v2/video_regeneration 将 768P 成片重生成为 2K 高清

原生接口透传

请求 / 响应字节形状镜像官方，迁移零改造

​
模型清单

三类任务（video_generation / h3_context_ir / video_regeneration）在请求体中 model 均填 MiniMax-H3，任务类型由调用的端点决定，响应里的 task_type 会回显 generation / h3_context_ir / regeneration。

​
技术规格

图生视频（首帧/尾帧）与多模态参考互斥：同一请求不能同时出现 first_frame/last_frame 与任意 reference_* 角色。

​
端点一览

Base URL：https://api.looprouter.com
所有接口统一使用 Authorization: Bearer sk-... 请求头，API Key 在 控制台 → 令牌 创建。

​
模型定价

计费采用提交预扣、完成结算的两段式流程，不同任务类型口径不同：
1

提交预扣

任务创建成功后按参数（分辨率、时长）预估并预扣一笔额度。视频再生无 duration，按最大可计费时长预扣。
2

完成结算

任务成功后按响应 usage 的实际用量结算（视频看 output_seconds，Context-IR 看 token），多退少补；任务失败或被取消全额退回。
768P / 2K 每秒单价与 Context-IR 每百万 token 单价请以控制台「模型广场」与「日志中心」展示为准。实际扣费还会应用 API Key 所在分组的计费倍率。

​
限流与重试

  • 收到 429（rate_limit_error）或 5xx（server_error）时，建议指数退避重试（2s → 4s → 8s）。
  • 轮询查询接口建议间隔约 10 秒；2K 与长时长任务生成耗时更久，请适当延长轮询周期。

​
常见问题

不是。MiniMax-H3 走原生 /v2/... 接口（无 /api 前缀），豆包 Seedance 走 /api/v3/contents/generations/tasks。请求体与响应体结构也不同，按各自文档接入。
这是异步任务：创建返回 task_id，需轮询 GET /v2/query/video_generation/{task_id} 直到 status 为 succeeded，再从 task.content.url 下载成片。
仅 768P 与 2K 两档。视频再生（regeneration）的输出恒为 2K。
任务与查询窗口仅覆盖近 7 天，超过 7 天的任务 ID 无法再查询。请在生成后尽快转存成片。
/v2/h3_context_ir 只做提示增强：成功后 task.content.prompt 返回结构化增强提示词，modality 为 text，不产出视频。

​
相关文档

视频生成 API

参数、示例、查询、列表、删除、提示增强与视频再生

快速开始

三步跑通第一个任务