/v2 完全一致:先提交任务拿到 task_id,再轮询查询接口获取成片。已有的官方示例代码只需替换 Base URL 与 Authorization 即可运行。
创建视频任务
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)。
素材数量与格式限制见 能力总览 → 技术规格。
生成模式
查询任务
GET /v2/query/video_generation/{task_id}
任务状态机:queued → running → succeeded / failed / cancelled。仅可查询近 7 天内的任务。
响应根对象包含一个 task 字段:
usage 字段:
成功响应示例:
任务列表
GET /v2/query/video_generation
分页查询近 7 天的任务,可按状态、任务 ID、模型、任务类型筛选。全部为可选查询参数:
响应为
{"items": [ ...VideoTask ], "total": n},元素结构与查询单个任务的 task 一致。
取消 / 删除任务
DELETE /v2/video_generation/{task_id}
按任务当前状态执行不同动作:
响应:
提示增强 · 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。可用两种方式指定源视频,二选一(不能同时提供,也不能都不提供):
- 方式一:按任务 ID
- 方式二:按源视频
直接引用一个已成功的
/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
相关文档
能力总览与定价
模型清单、技术规格、计费规则
快速开始
三步跑通第一个任务