Hailuo 02

Q: 一次调用可以设置哪些选项？

时长：6, 10 秒。 分辨率：480p, 720p, 1080p。 宽高比：16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21。

Q: 生成失败怎么办？

失败的任务全额退款。你只为结果付费。

API 已上线

来自 MiniMax视频hailuo-02

$0.013/秒$0.01667-22%

480p价格核对于 2026年10月15日

价格核对于 2026年10月15日

输入 → 输出: 文本提示词图像视频
时长: 6–10 秒
画质: 480p · 720p · 1080p

Hailuo 02

MiniMax

$0.013/秒起 · 比官方低 22%

输入

提示词prompt片段中发生的内容。

69 / 4,000

起始图片网址image第一帧,公开的 https 链接。

09389f4f-cd67-4172-b2a2-fb2998ec858e_example.jpg

画质quality

时长duration

画面比例跟随你的起始图。

比官方价 $0.10 低 22% · 480p × 6 秒比官方低 22%

示例

示例输出用此提示词生成

Hailuo 02 API 价格

我们销售的每个档位，并列显示模型厂商的官方价。

全部价格

Hailuo 02 各档位价格（美元）
档位	Opennan	官方价
480p, 标准	$0.013/秒6 秒 $0.078	$0.01667/秒低 22%
720p, 标准	$0.0325/秒6 秒 $0.195	$0.04667/秒低 30%
1080p, 标准	$0.06175/秒6 秒 $0.3705	$0.08167/秒低 24%

官方价是模型厂商自己对同一档位的标价。厂商公布价格的，我们绝不高于该价格销售，大多数档位至少低 10%。

从代码调用 Hailuo 02

首次调用所需的一切都在本页：接口地址、密钥、请求和每个参数。

POSThttps://api.opennan.com/v1/videos/generations

获取 API 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥

发送第一个请求

与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。

curl https://api.opennan.com/v1/videos/generations \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hailuo-02","prompt":"夜晚霓虹街道上的雨，镜头缓慢推进","duration":6,"quality":"720p","aspect_ratio":"16:9"}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

查询任务
调用会立即返回任务 ID。查询任务直到完成：
GEThttps://api.opennan.com/v1/tasks/{id}
queued
等待处理
running
生成中
succeeded
完成：outputs[].url 中是文件
failed
失败：不收费

参数

根据实时目录生成：这里列出的每个值 API 都接受。

参数
名称	类型	可用值	默认值	对价格的影响
`model`必填执行调用的模型。	字符串	hailuo-02	—	—
`prompt`可选视频里发生什么。不发送起始图时必填。	字符串	—	—	—
`image`可选起始图（https 链接）。视频从这里开始。	URL	—	—	—
`duration`可选视频时长（秒）。	整数	6 · 10	6	越长越贵
`quality`可选输出分辨率。	字符串	480p · 720p · 1080p	720p	越高越贵
`aspect_ratio`可选画面比例，例如 16:9 或 9:16。	字符串	16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21	16:9	—
`callback_url`可选任务完成后发送到此 URL。	URL	—	—	—

错误及解决方法

401缺少密钥或密钥错误
用 Authorization: Bearer 请求头发送控制台中的密钥。
402余额不足
在账单页面充值，然后重新发送同一请求。
400有值不被接受
查看 error.message，它会指出字段。请使用参数表中的值。
429请求过多
等几秒再试，每次遇到 429 都等得更久一些。

把 Opennan 添加到你的 AI 应用

安装一次，你的 AI 就能使用 Opennan 的全部工具：视频、图片、聊天、语音、音乐、音效、3D、字幕和配音。选择你的应用，按步骤操作。

MCP 服务器https://api.opennan.com/v1/mcp

适用于 Codex CLI、Codex 应用和 Codex IDE 扩展：它们共用 ~/.codex/config.toml。如果应用或 IDE 读不到 OPENNAN_KEY，请用写入密钥的 config.toml 方式。Codex 每次调用工具前会询问，批准即可继续。

获取 API 密钥
在控制台创建密钥。密钥以 sk- 开头，与网站共用同一余额。
创建密钥

把密钥保存为 OPENNAN_KEY

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
安装 Opennan 插件：包含服务器，以及教 AI 选择模型、确认价格、等待结果的技能
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

或者只添加服务器

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

或者把这段加到 ~/.codex/config.toml

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
确认列表里有 opennan
```
codex mcp list
```
重启 Codex，然后让它做任何事
“做一段 5 秒的霓虹街道下雨视频，再配一首歌和一张海报图。”

把 sk-... 换成你自己的密钥并妥善保管：拿到它的人可以花你的余额。没有密钥时应用也能列出工具，但生成内容需要密钥。

在 AI 智能体中使用

把 Opennan MCP 服务器加到你的智能体中，然后调用此工具。

工具: generate_video
示例参数: { "model": "hailuo-02", "prompt": "夜晚霓虹街道上的雨，镜头缓慢推进", "duration": 6 }

Hailuo 02 API 常见问题

Hailuo 02 API 多少钱？

Opennan 上的 Hailuo 02 API：480p 下 $0.013/秒，比 MiniMax 官方价 $0.01667/秒低 22%。价格以美元按每次调用计算，运行前显示，所有档位都列在价格表中。

与官方价相比如何？

MiniMax 标价 $0.01667/秒；Opennan 收费 $0.013/秒，低 22%。只有低于厂商官方价的档位我们才销售，大多数至少低 10%。

Hailuo 02 支持哪些输入？

文本提示词、图像。

一次调用可以设置哪些选项？

时长：6, 10 秒。分辨率：480p, 720p, 1080p。宽高比：16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21。

如何计费？

按视频计费：价格取决于分辨率、时长和声音，调用前显示。

生成失败怎么办？

失败的任务全额退款。你只为结果付费。

如何从 AI 智能体调用 Hailuo 02？

添加 MCP 服务器 https://api.opennan.com/v1/mcp，用你的 API 密钥作为 bearer token，然后以 model "hailuo-02" 调用 generate_video 工具。或向 https://api.opennan.com/v1/videos/generations 发送 POST 请求。