用于视频生成的 MiniMax H3 API

通过独立的 GoEnhance Open API 调用 MiniMax H3。把文本、帧图像或参考素材提交到异步 REST 流程,拿到 img_uuid,之后轮询结果或注册回调。H3 在生成画面的同一遍里就生成原生立体声音频——对白、音效和环境底噪。
创建 API Key
专业布光摄影棚内,导演站在电影摄影机旁

按输入类型选择对应的 H3 模型

hailuo_h3:文本、首帧或首尾帧

用 hailuo_h3 做文生视频、配合 image_url 做图生视频,或再加可选的 image_end_url 做首尾帧控制。prompt 为必填,最长 7,000 字符。可查看在线调试台与完整参数说明。
创作者使用专业摄影与灯光设备拍摄产品短片

hailuo_h3_refs:参考素材驱动生成

当单次请求需要最多 9 张参考图、3 段参考视频和 3 段参考音频时,用 hailuo_h3_refs。该路径走 MiniMax 官方通道,可输出 768P 与 2K。详见参考图生视频端点。
hailuo_h3_refs:参考素材驱动生成

独立的统一 API 接入

GoEnhance Open API 是独立的第三方平台,为多种视频与图像模型提供统一接入。它不是 MiniMax,也不是海螺,与 MiniMax 无隶属关系、未获其背书。MiniMax 和海螺为其所有者的商标,此处仅用于指代模型。
独立的统一 API 接入
提交前先校验这些字段,让不合法的请求在扣点之前就被拦下。

MiniMax H3 API 参数与限制

共用端点,异步返回

两个模型都提交到 POST https://api.goenhance.ai/api/v1/videos/generations。响应先返回 img_uuid,生成过程异步继续。

hailuo_h3 的时长与提示词

duration 必须是 5 到 15 秒之间的整数,默认 5。非整数或超范围的值会在扣点之前被拒绝。prompt 为必填,最长 7,000 字符。

hailuo_h3 的分辨率与画面比例

可选 480p、720p 或 2K。仅在文生视频时,ratio 可取 21:9、16:9、4:3、1:1、3:4 或 9:16。当 image_url 提供了首帧时,输出跟随该图,ratio 参数不生效。

hailuo_h3 的帧输入

用 image_url 传首帧,可选用 image_end_url 传尾帧。这一个模型 ID 覆盖文生视频、图生视频和首尾帧生成三种用法。

hailuo_h3_refs 的参考素材输入

单次请求最多接受 ref_imgs 里 9 张图、ref_videos 里 3 段视频、ref_audios 里 3 段音频。时长为 5 到 15 秒的整数,默认 5;分辨率可选 768P 或 2K。

原生立体声音频

H3 在生成画面的同一遍里就生成对白、音效和环境底噪,是原生立体声音频,而不是事后再配音。
单次调用的费用 = 所选档位的每秒单价 × 请求的输出时长。视频模型按输出秒数计费。

MiniMax H3 按秒计价

hailuo_h3 — 480p:每秒 $0.030

GoEnhance 自有管线档位,用于低成本反复调提示词。它不是 MiniMax 官方支持的输出档位。

hailuo_h3 — 720p:每秒 $0.060

GoEnhance 自有管线档位,用于以更低成本试跑、再挑选最终成片。它不是 MiniMax 官方支持的输出档位。

hailuo_h3 — 2K:每秒 $0.090

选定的成片需要 MiniMax 官方输出分辨率时,用 2K 档位。

hailuo_h3_refs — 768P:每秒 $0.099

参考素材驱动的生成只走 MiniMax 官方通道,因此档位和价格都与上面不同。

hailuo_h3_refs — 2K:每秒 $0.143

参考素材驱动请求的 2K 官方通道档位。

token、退款与并发

用量按 token 计费:$10 可买 500 token,即每 token $0.02。点数在提交时一次性扣除,生成失败则全额退回。并发数取决于账户的 Build Tier,起步为 3 个同时进行中的任务。详见价格档位与点数。

接入 MiniMax H3 视频 API

1

1. 创建并妥善保管 API Key

在 /keys 创建 Key,以 Authorization: Bearer <API key> 的形式发送;不要暴露在浏览器端代码或日志里。
2

2. 选定模型并校验请求

要文本或帧控制就选 hailuo_h3,要参考素材就选 hailuo_h3_refs。提交前先校验时长、分辨率、ratio 是否适用、提示词长度和各类输入的数量。
3

3. 提交并保存 img_uuid

把请求 POST 到 https://api.goenhance.ai/api/v1/videos/generations。任务是异步的,务必把返回的 img_uuid 存进你自己的任务记录。
4

4. 轮询或接收回调

轮询 GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=...,或注册回调 URL。任务开始运行时会发出一次 status=0 的回调;终态回调则带上结果。
5

5. 处理校验失败、生成失败与并发

时长非法或输入组合不兼容时,不要原样重试。生成失败会全额退款。进行中的任务达到 Build Tier 允许的并发上限时,请把新提交排队。
创建 API Key
围绕异步任务、原生音频和明确的帧或参考输入,搭建可复用的媒体生产流水线。

开发者用 H3 做出了什么

程序化广告素材

用结构化提示词批量生成短广告创意,再只保留通过审核的产出。

产品短片流水线

把产品图作为首帧,生成画面比例跟随该图的短片。

多语言视频广告

一遍生成画面、对白、音效和环境底噪,再把每条结果送进你的本地化与审核流程。

UGC 生产系统

把投稿、任务追踪、回调、内容审核和素材存储串成一条自动化的短视频生产链路。
限制、模型选择、计费、音频,以及平台关系。

MiniMax H3 API 常见问题

MiniMax H3 API 支持多长的时长?

hailuo_h3 和 hailuo_h3_refs 都接受 5 到 15 秒之间的任意整数,默认 5。非整数或超范围的值会在扣点之前被拒绝。

为什么 H3 有两个模型 ID?

MiniMax 把帧控制和参考素材视为互斥。因此 GoEnhance 用 hailuo_h3 对应首尾帧流程、hailuo_h3_refs 对应参考素材驱动的生成,而不是把运行时会冲突的参数糅在一起。

480p 和 720p 是 MiniMax 官方的输出档位吗?

不是。MiniMax 官方只输出 2K。hailuo_h3 上的 480p 和 720p 档位跑在 GoEnhance 自有管线上,用于更省成本地试跑,最后只对要保留的成片用 2K。

为什么 hailuo_h3_refs 更贵?

hailuo_h3_refs 只走 MiniMax 官方通道。可选分辨率为 768P 和 2K,每秒单价分别是 $0.099 和 $0.143。

计费是怎么算的?

按 token 计费:$10 可买 500 token,即每 token $0.02。视频按输出秒数乘以对应单价。点数在任务提交时一次性扣除,生成失败则全额退回。

MiniMax H3 会生成音频吗?

会。H3 在生成视频的同一遍里就生成原生立体声的对白、音效和环境底噪,而不是事后再加配音。

怎么知道视频生成好了?

存下返回的 img_uuid,轮询任务详情端点,或注册回调 URL。开始回调用 status=0 标识;终态回调带上结果。

GoEnhance Open API 和 MiniMax、海螺有隶属关系吗?

没有。GoEnhance Open API 是独立的第三方 API 平台,既不是 MiniMax 也不是海螺,与 MiniMax 无隶属关系、未获其背书。这些名称仅用于指代模型,归其所有者所有。

无代码的 MiniMax H3 编辑器在哪?

本页面面向 REST API 接入。如果你要的是面向普通用户的编辑器,请访问 MiniMax H3 视频模型页。

开始接入 MiniMax H3 API