MiniMax H3 Max Turbo

MiniMax H3 Max Turbo 根据文本或首尾帧图片生成短视频。使用模型 ID minimax-h3-max-turbo，保存返回的任务 ID，轮询获取完成的视频。本页介绍 SeedRouter 提供的原生 content 数组接口。

模型 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-turbo",
    "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 的图片视为首帧。最多接受一张首帧和一张尾帧；尾帧必须搭配首帧。不支持参考图片、视频与音频。

模式

模式由 content 中的条目决定，无需发送 mode 字段。

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

首尾帧图片

使用不含嵌入式凭据的公开 HTTP(S) URL。不接受 Base64 与 mm_file:// ID。图片可为 JPG、JPEG、PNG、WebP、HEIC 或 HEIF，每张最大 30 MB，每条边 256–5760 像素，宽高比为 0.4 至 2.5。生成前会检查输入。双帧请使用匹配的构图与宽高比。

内容过滤

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

计费维度

模型价格区块显示当前费率。Turbo 只有一项费用：按所选分辨率计算的输出秒数。首尾帧与提示词扩写没有单独费用。

cost = reported output seconds × output-second rate for the resolution

预估采用请求中的整数秒时长。最终按已完成任务的输出秒数用量及受理请求时记录的费率计费。无法取得有效用量时，采用受理时的预估值。媒体容器时长可能与计费秒数略有差异。可在账户用量历史中查看扣费，公开任务响应不含费用。失败任务不收费。

输出结构

提交后返回任务：

{"id": "task_...", "model": "minimax-h3-max-turbo", "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-turbo",
  "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-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

使用建议

• 每个镜头描述一个主体、动作、运镜和布光方案。
• 用 480P 做初稿，需要更多输出细节时选 768P。每次重新生成都是单独付费的请求。
• 提供首帧来确定开场构图；只有同时提供首帧时才能添加尾帧。
• 使用 extra.prompt_expansion_mode 选择 disabled、balanced 或 quality；省略时保留 balanced。
• 发布前检查完整视频与音频。提示词不能保证产品几何形状或文字完全准确。

相关链接

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

契约范围

此接口使用 MiniMax 的 content 数组请求格式，配合 SeedRouter 模型 ID、异步任务、仅 URL 图片输入与托管结果交付。不支持回调与取消。content_filter 是 SeedRouter 输入检查，并非 MiniMax 参数。

单独的 fal 托管接口使用不同字段与限制；其 1080P、小数时长、目标音频和有序参考素材控件不适用于此处。本接口不接受 seed 与水印控件。区别与来源链接请见对比指南。