Skip to Content
模型用法Hailuo（MiniMax）

Hailuo（MiniMax）系列

MiniMax 的海螺视频生成模型，共两款，通过 OfoxAI 视频接口 POST /v1/videos 调用。任务以异步方式执行：创建任务后获得任务 ID，再通过该 ID 查询结果。

模型选择

要点需要 2K 输出时选用 Hailuo 3；需要 480p 时选用 Hailuo 3 Max。两款均不支持 720p 与 1080p。
模型分辨率（默认）时长画幅
Hailuo 3768p 2k（768p）4–15 秒21:9 16:9 4:3 1:1 3:4 9:16 adaptive
Hailuo 3 Max480p 768p（768p）5–15 秒同上

两款均支持文生视频、图生视频与视频参考，并可生成同步音轨（generate_audio 默认为 true）。adaptive 表示沿用输入图片的比例。

模型 ID（调用时原样复制）
Hailuo 3minimax/hailuo-3768p、2K
Hailuo 3 Maxminimax/hailuo-3-max480p、768p，最短 5 秒

上表与 Models API 返回的 video_attributes 一致；模型能力如有调整，以接口返回为准。按秒计费，实际费用以任务结果中的 usage.video_cost 为准，价格请参阅模型页 。

调用示例

以下示例只展示创建任务的请求。创建后查询状态、下载结果的完整流程见 Video API · 快速开始。

仅传 prompt。

Terminal
curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "宽银幕镜头：沙漠公路上一辆复古汽车驶向落日",
    "duration": 6,
    "resolution": "768p",
    "aspect_ratio": "21:9"
  }'
  • frame_images 与 input_references 不可同时传入，同时传入返回 400 references_conflict。
  • 不需要音轨时传入 "generate_audio": false。
  • 字段结构的完整说明见创建视频任务。

分辨率写法

海螺的分辨率档位与其他系列不同，为 768p 与 2k（小写 k）。传入其他系列常用的 720p、1080p 将返回 400。

常见报错

要点参数校验错误在创建时即返回，不会创建任务，也不产生费用。报错信息中会列出允许的取值。
HTTP · code报错原文原因处理方法
400 unsupported_parameterresolution "1080p" not supported; allowed: [768p 2k]海螺不支持 1080pHailuo 3 请使用 768p 或 2k
400 unsupported_parameterduration 4 out of range [5, 15]Hailuo 3 Max 最短为 5 秒改为 5 秒及以上，或改用 Hailuo 3
400 references_conflictframe_images and input_references are mutually exclusive同时传入了两种素材字段两者只能选择其一
404 model_not_foundmodel not found模型 ID 拼写错误从本页复制模型 ID

完整错误码见 Video API 错误码。

官方文档

常见问题

海螺 Hailuo 3 支持 1080p 吗？

不支持。Hailuo 3 的分辨率是 768p 和 2k，Hailuo 3 Max 是 480p 和 768p。传 720p 或 1080p 会返回 400 resolution not supported。

Hailuo 3 Max 报错 duration 4 out of range [5, 15]？

Hailuo 3 Max 单个任务最短 5 秒，最长 15 秒。需要 4 秒的视频请使用 Hailuo 3。

海螺视频支持 21:9 吗？

支持。Hailuo 3 和 Hailuo 3 Max 都支持 21:9、16:9、4:3、1:1、3:4、9:16 和 adaptive。

最后更新于
Wan 与 HappyHorseElevenLabs