MiniMax H3 Max Turbo 上手指南：文生视频、首尾帧图生视频、参数与价格

MiniMax H3 Max Turbo 是 H3 Max 的高速档，在 HiAPI 上有两个调用 ID：minimax-h3-max-turbo/text-to-video（文生视频）和 minimax-h3-max-turbo/image-to-video（首帧图生视频，可加尾帧）。单条 1–15 秒，480P / 768P / 1080P 三档，按秒计费。这篇文章讲两个 ID 怎么选、参数怎么填、价格怎么算。

两个 ID 怎么选

• 只有文字描述：用 text-to-video，必填只有 prompt，画幅用 aspect_ratio 指定。
• 已经有画面：用 image-to-video，必填 prompt 和 image_url（首帧）。可再给 end_image_url 作为尾帧，模型在两帧之间补出运动。
• 图生视频的输出画幅跟随首帧图，没有 aspect_ratio 参数。要竖屏就传竖图，首尾帧的比例尽量一致。

参数

• resolution：480P / 768P / 1080P，默认 768P。1080P 是在 768P 画面上做细化得到的，原生生成最高到 768P。
• duration：1–15 秒，默认 5，可以填小数。实际输出最多会比填的时长长约 0.7 秒，例如填 5 秒，得到的片段约 5.2 秒。
• aspect_ratio（仅文生视频）：21:9、16:9、4:3、1:1、3:4、9:16，默认 16:9。例如 768P 3:4 输出 768×1024，768P 21:9 输出 1536×672。
• prompt_expansion_mode：提示词扩写。disabled 原样使用；balanced（默认）约 1 秒完成改写；quality 最多花约 30 秒写得更细。
• target_audio_url：可选，传一段至少 2 秒、不超过 15MB 的音频作为成片音轨，比视频长的部分会被截掉。用它时 duration 至少填 2。
• seed：可选，想复现同一结果时固定它，其余参数也要保持不变。
• 每次请求出 1 条视频。这两个 ID 不提供参考图锁定角色、视频续写和视频编辑。

调用示例

提交任务：

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo/image-to-video",
    "input": {
      "prompt": "The cyclist slows near the street lamp and turns to look back, rain streaks in warm neon light, slow push-in",
      "image_url": "https://example.com/first-frame.png",
      "resolution": "768P",
      "duration": 5
    }
  }'

返回 data.taskId 后轮询 GET https://api.hiapi.ai/v1/tasks/<taskId>。status 变成 success 时，视频地址在 data.output[0].url。5 秒 768P 一般十几秒就能出结果。结果链接有有效期（字段 expireAt），需要长期保存请自行下载转存。

价格

• 480P：每秒 $0.025。
• 768P：每秒 $0.04。
• 1080P：每秒 $0.08。
• 按请求填写的 duration 计费，两个 ID 同价。例如 768P 5 秒：5 × 0.04 = $0.20；1080P 10 秒：$0.80。
• 只对成功生成的任务扣费，任务失败全额退款。

提示词怎么写

• 文生视频按「主体 + 场景 + 动作 + 镜头运动 + 光线与氛围」的顺序写清楚。
• 图生视频的首帧已经定了构图，少重复画面里已有的内容，把「谁怎么动、镜头怎么走、几秒内完成」写足，例如「镜头缓慢推近，人物在第 3 秒回头」。
• 先用 480P、短时长试动作和运镜，满意后再出 768P 或 1080P。1080P 单价是 480P 的 3.2 倍。