MiniMax H3 Max

MiniMax H3 Max 是 MiniMax H3 中面向更快生成的变体。一次请求同时生成画面与声音：480P 或 768P、5–15 秒的视频，包含对白、环境声与音效。请求体采用 MiniMax 官方格式，模型 ID 为 minimax-h3-max。提交后保存返回的任务 ID，从任务中获取完成的视频。首尾帧与参考素材均通过 URL 传入。

模型 ID

当前价格请见模型页面。

快速示例

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

端点

POST https://api.seedrouter.ai/v1/videos/generations

响应返回任务（{"id": "task_...", "status": "processing"}），而非已完成的视频。轮询 GET /v1/tasks/{task_id} 获取结果。请将 API Key 保存在服务器端代码中。

参数

schema 采用严格校验：未知字段会被拒绝，不会忽略。不支持 callback_url，请改为轮询任务。extra 是可选的严格对象，只能包含 prompt_expansion_mode。所有字段均不接受 null；可选字段请直接省略。

content 条目

单张未指定 role 的图片视为首帧。有多张图片时，每张都需指定 role。

模式

模式由 content 中的条目决定，没有 mode 字段。

同一请求不能混用首尾帧与参考素材。官方文档列出了仅尾帧输入，但又有必须搭配首帧的冲突要求。SeedRouter 尚未验证该情况。需要结尾图片时，请同时提供首尾帧。

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

媒体输入

每个图片、视频和音频条目都需使用公开 HTTP(S) URL。不接受 Base64 data URI 与 mm_file:// ID：请上传文件到自己的存储，再传入 URL。

参考视频会在受理请求时测量时长；无法读取时长的视频会被拒绝，不收费。其他限制在生成前检查，违反限制的请求会失败，不收费。

内容过滤

未设置时，content_filter 为 true。启用后，请求中的文本与媒体会在生成前接受审核。被拦截的请求以代码 60001 失败，不收费。将 content_filter 设为 false 可跳过审核；网站 Playground 始终启用过滤。

计费维度

当前费率请见模型价格区块。MiniMax H3 Max 根据输出分辨率，将生成的输出秒数与参考视频秒数分别计费。前两张图片免费，此后每张另行收费。

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

参考视频时长相加后，四舍五入为整数秒作为最终用量。因此，两段 2.4 秒视频贡献五个输入秒数。参考音频没有输入费用。首尾帧计入图片数量，因此仅两张首尾帧不会产生图片费用。

Playground 预估会将参考视频时长向上取整，以覆盖可能的最终费用。最终用量按请求时记录的费率计价。无法取得完整用量报告时，采用受理时的预估值。可在账户用量历史中查看扣费，公开任务响应不含费用。失败任务不收费。

输出结构

提交后返回任务：

{"id": "task_...", "model": "minimax-h3-max", "status": "processing", "created_at": 1789689600}

获取任务

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每 10–20 秒轮询一次，直到 status 为 completed 或 failed。轮询时网络超时不代表生成失败：保留任务 ID 并继续查询。不要为了查看进度而创建另一个任务。

已完成任务

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio 是视频实际生成的宽高比，也包括使用 adaptive 时选择的比例。任务在有报告时包含实际分辨率、比例和时长。上述 JSON 仅用于展示响应结构，不是实测生成结果。

错误

创建任务前被拒绝的请求会返回 HTTP 错误与 error 对象，不收费。受理后失败的任务，在查询时返回 HTTP 200，包含 status: "failed" 与 error 对象。

错误代码、HTTP 状态与重试建议请见公共错误目录。

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

提交本身超时时，请先检查任务再重新提交：第一次请求可能已被受理。

使用建议

• 同时描述镜头与声音：主体、地点、运镜、光线、对白和音效。
• 将对白写入提示词；需要声音遵循参考时，附上参考音频。
• 用 480P 做初稿，需要更多细节时选 768P。重新生成是单独付费的请求。
• 提示词已完整时使用 extra: {"prompt_expansion_mode": "disabled"}，也可选择 balanced / quality 扩写。
• 用首帧和尾帧控制镜头的起止；用参考素材帮助保持产品、人物或动作特征。
• 添加 no text, no logos，避免生成虚构标记。

相关链接

• MiniMax H3 Max Playground 与价格
• 下载 OpenAPI
• 可复制的 Markdown

契约来源

参数以 MiniMax 视频生成文档为准。SeedRouter 使用自己的模型 ID、异步任务接口、仅 URL 媒体输入与托管结果交付；不支持回调与取消。content_filter 是 SeedRouter 扩展。