用于文生视频和图生视频的 Hailuo 2.3 API

通过独立的 GoEnhance API 访问 Hailuo 2.3。提交文本提示词或添加首帧图片,获取 img_uuid,然后轮询异步任务或通过回调处理状态更新。GoEnhance 提供第三方访问,并非 MiniMax,也不是 MiniMax 官方 API。
创建 API Key
电影感视频制作场景,展示 Hailuo 2.3 API 生成

选择 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

1. 创建密钥并构建请求

创建 API 密钥,将其保存在服务器上,并发送 bearer 认证。通过 model: hailuo_2_3、提示词以及有效的时长和分辨率,POST 到 https://api.goenhance.ai/api/v1/videos/generations
2. 保存返回的 img_uuid
2

2. 保存返回的 img_uuid

将提交和生成视为独立阶段。将返回的 img_uuid 随您自己的任务记录一并持久化,这样重试和用户会话不会丢失任务标识。
3. 轮询或处理回调
3

3. 轮询或处理回调

轮询 GET /api/v1/jobs/detail,或提供一个公开的 HTTPS 回调 URL。GoEnhance 会推送状态变更,并对返回非 200 的回调最多重试三次,每次尝试超时三秒。
在可重复提交和异步交付比手动编辑更重要的场景中使用 API。

开发者用 Hailuo 2.3 构建了什么

自动化广告创意

将已批准的广告系列提示词转化为短视频候选,并将每个完成的素材路由到审核队列。

产品图片动画

使用产品静态图作为首帧,为目录、发布或演示工作流创建动态化片段。

编辑与社交媒体流水线

将结构化提示词、异步任务跟踪、回调、审核和存储连接起来,以实现可重复的短视频制作。
关于模型输入、Hailuo 2.3 API 定价、异步任务、回调以及 MiniMax API 定位的解答。

Hailuo 2.3 API 常见问题

开始集成 Hailuo 2.3 API

Hailuo 2.3 API 定价与集成 | GoEnhance