用于视频生成的 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。详见参考图生视频端点。
独立的统一 API 接入
GoEnhance Open API 是独立的第三方平台，为多种视频与图像模型提供统一接入。它不是 MiniMax，也不是海螺，与 MiniMax 无隶属关系、未获其背书。MiniMax 和海螺为其所有者的商标，此处仅用于指代模型。
提交前先校验这些字段，让不合法的请求在扣点之前就被拦下。
MiniMax H3 API 参数与限制
共用端点，异步返回
两个模型都提交到 <code>POST https://api.goenhance.ai/api/v1/videos/generations</code>。响应先返回 <code>img_uuid</code>，生成过程异步继续。
hailuo_h3 的时长与提示词
<code>duration</code> 必须是 5 到 15 秒之间的整数，默认 5。非整数或超范围的值会在扣点之前被拒绝。<code>prompt</code> 为必填，最长 7,000 字符。
hailuo_h3 的分辨率与画面比例
可选 480p、720p 或 2K。仅在文生视频时，<code>ratio</code> 可取 21:9、16:9、4:3、1:1、3:4 或 9:16。当 <code>image_url</code> 提供了首帧时，输出跟随该图，ratio 参数不生效。
hailuo_h3 的帧输入
用 <code>image_url</code> 传首帧，可选用 <code>image_end_url</code> 传尾帧。这一个模型 ID 覆盖文生视频、图生视频和首尾帧生成三种用法。
hailuo_h3_refs 的参考素材输入
单次请求最多接受 <code>ref_imgs</code> 里 9 张图、<code>ref_videos</code> 里 3 段视频、<code>ref_audios</code> 里 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 个同时进行中的任务。详见<a href="/billing">价格档位与点数</a>。
接入 MiniMax H3 视频 API
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 允许的并发上限时，请把新提交排队。
围绕异步任务、原生音频和明确的帧或参考输入，搭建可复用的媒体生产流水线。
开发者用 H3 做出了什么
程序化广告素材
用结构化提示词批量生成短广告创意，再只保留通过审核的产出。
产品短片流水线
把产品图作为首帧，生成画面比例跟随该图的短片。
多语言视频广告
一遍生成画面、对白、音效和环境底噪，再把每条结果送进你的本地化与审核流程。
UGC 生产系统
把投稿、任务追踪、回调、内容审核和素材存储串成一条自动化的短视频生产链路。
限制、模型选择、计费、音频，以及平台关系。