MiniMax-H3 采用异步任务模式,接口与 MiniMax 官方 /v2 完全一致:先提交任务拿到 task_id,再轮询查询接口获取成片。已有的官方示例代码只需替换 Base URL 与 Authorization 即可运行。
接入前请注意以下要点:
  1. Base URL 为 https://api.looprouter.com,端点是 /v2/video_generation 等,没有 /api 前缀。
  2. 鉴权用 LoopRouter 令牌:Authorization: Bearer sk-...(不是 MiniMax 官方的 JWT)。
  3. resolution 只有 768P 与 2K 两档;duration 为 4–15 秒整数。
  4. 成功状态是 succeeded;成片 task.content.url 为限时链接,且任务仅可查询近 7 天,请尽快转存。
  5. 文生视频(t2v)时 ratio 必填且不能是 adaptive;图生视频(i2v)时比例由输入图决定、ratio 恒按 adaptive 处理。

创建视频任务

POST /v2/video_generation

请求参数速查

content 数组

每个元素是一个内容项,type 决定其结构,可选 role 指定用途: URL 支持三种形式:公网 URL、Base64 data URI(data:image/...、data:video/mp4;...、data:audio/...),或已上传至 MiniMax 文件接口的 mm_file://{file_id}。大文件建议用公网 URL(请求体整体 ≤64MB)。 素材数量与格式限制见 能力总览 → 技术规格。

生成模式

图生视频(first_frame/last_frame)与多模态参考(reference_*)互斥,不能在同一请求中混用。

查询任务

GET /v2/query/video_generation/{task_id} 任务状态机:queued → running → succeeded / failed / cancelled。仅可查询近 7 天内的任务。 响应根对象包含一个 task 字段: usage 字段: 成功响应示例:
失败响应示例:
task.content.url 为限时下载链接,请及时转存;下载时请求中不要携带 Authorization 头。

任务列表

GET /v2/query/video_generation 分页查询近 7 天的任务,可按状态、任务 ID、模型、任务类型筛选。全部为可选查询参数: 响应为 {"items": [ ...VideoTask ], "total": n},元素结构与查询单个任务的 task 一致。

取消 / 删除任务

DELETE /v2/video_generation/{task_id} 按任务当前状态执行不同动作: 响应:
该端点同样适用于 Context-IR 与视频再生的任务记录。

提示增强 · Context-IR

POST /v2/h3_context_ir 理解多模态上下文,输出一段结构化增强提示词,用于提升后续视频生成质量。它不生成视频:成功后 task.content.prompt 返回增强提示词,modality 为 text,按 token 计费。 请求参数与视频生成基本一致(model、content、duration 必填,ratio、callback_url 可选),差别是没有 resolution。
查询成功示例(task_type 为 h3_context_ir,content.prompt 承载增强提示词):

视频再生 · Regeneration

POST /v2/video_regeneration 将符合 MiniMax-H3 768P 输出规格的源视频重生成为 2K 高清。输出恒为 2K,无需 duration。可用两种方式指定源视频,二选一(不能同时提供,也不能都不提供):
直接引用一个已成功的 /v2/video_generation 任务:
两种方式都返回 {"task_id": "..."},轮询查询接口获取结果;成功任务的 task_type 为 regeneration。

错误响应

所有错误采用 MiniMax 原生结构(顶层含 type: "error"):
错误 message 末尾括号内为上游内部错误码(如 (1002))。429 与 5xx 建议指数退避重试(2s → 4s → 8s)。

在线调试(试一试)

在 API 参考中可对每个 /v2 端点直接发起真实请求:

创建视频任务

POST /v2/video_generation

查询任务

GET /v2/query/video_generation/

任务列表

GET /v2/query/video_generation

取消 / 删除

DELETE /v2/video_generation/

提示增强 Context-IR

POST /v2/h3_context_ir

视频再生 768P→2K

POST /v2/video_regeneration

相关文档

能力总览与定价

模型清单、技术规格、计费规则

快速开始

三步跑通第一个任务