img_uuid,然后轮询异步任务或通过回调处理状态更新。GoEnhance 提供第三方访问,并非 MiniMax,也不是 MiniMax 官方 API。用于文生视频和图生视频的 Hailuo 2.3 API
通过独立的 GoEnhance API 访问 Hailuo 2.3。提交文本提示词或添加首帧图片,获取
创建 API Key
选择 Hailuo 2.3 生成模式
在发送生成请求之前,请一并校验模式、时长与分辨率。
Hailuo 2.3 API 参数与校验
模型与提示词
将 <code>model</code> 设置为 <code>hailuo_2_3</code>。每个请求都必须提供描述视频的文本 <code>prompt</code>。
可选的首帧图片
提供 <code>image_url</code> 来执行图生视频。如果执行文生视频,则省略该字段。该值必须是服务可访问的有效图片 URL。
时长规则
<code>duration</code> 字段接受 6 或 10 秒,默认为 6。1080P 请求仅支持 6 秒。
分辨率选项
选择 <code>768P</code> 或 <code>1080P</code>;默认为 768P。10 秒选项仅在 768P 下可用。
文生视频比例
对于文生视频请求,使用可选的 <code>ratio</code> 字段。不要依赖它来覆盖首帧图片。
异步完成
提交成功后返回 <code>img_uuid</code>。轮询 <code>GET /api/v1/jobs/detail</code>,或提供 <code>custom_callback_url</code> 以获取状态更新。
GoEnhance 的定价为每条视频每 token $0.02。提交前请选择有效的分辨率与时长的组合。
Hailuo 2.3 API 定价
768P,6 秒 — 18.2 tokens($0.364)
这是完整视频请求中列出的最低 Hailuo 2.3 API 价格。
768P,10 秒 — 36.4 tokens($0.728)
当应用需要 768P 下所支持的更长时长时,使用该档位。
1080P,6 秒 — 31.85 tokens($0.637)
Hailuo 2.3 支持 1080P 6 秒;不支持 10 秒的 1080P 请求。
集成 Hailuo 2.3 API
1
1. 创建密钥并构建请求
创建 API 密钥,将其保存在服务器上,并发送 bearer 认证。通过
model: hailuo_2_3、提示词以及有效的时长和分辨率,POST 到 https://api.goenhance.ai/api/v1/videos/generations。 2
2. 保存返回的 img_uuid
将提交和生成视为独立阶段。将返回的
img_uuid 随您自己的任务记录一并持久化,这样重试和用户会话不会丢失任务标识。 3
3. 轮询或处理回调
轮询
GET /api/v1/jobs/detail,或提供一个公开的 HTTPS 回调 URL。GoEnhance 会推送状态变更,并对返回非 200 的回调最多重试三次,每次尝试超时三秒。在可重复提交和异步交付比手动编辑更重要的场景中使用 API。
开发者用 Hailuo 2.3 构建了什么
自动化广告创意
将已批准的广告系列提示词转化为短视频候选,并将每个完成的素材路由到审核队列。
产品图片动画
使用产品静态图作为首帧,为目录、发布或演示工作流创建动态化片段。
编辑与社交媒体流水线
将结构化提示词、异步任务跟踪、回调、审核和存储连接起来,以实现可重复的短视频制作。
关于模型输入、Hailuo 2.3 API 定价、异步任务、回调以及 MiniMax API 定位的解答。


