> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax H3（海螺）视频生成 API 上线：价格与调用

> 老张API上线 MiniMax H3 视频生成（MiniMax-H3）：768P 与 2K 按秒计费的价格、可用分组和令牌计费模式，以及第一条视频的调用方法。

MiniMax H3 视频生成已在老张API上线，普通分组的令牌即可调用，768P 每秒 \$0.05，也可以输出 2K。

* **发布日期**：2026 年 10 月 24 日
* **最后核对**：2026 年 10 月 24 日
* **当前状态**：有效

## 关键信息

| 项目 | 内容 |
| - | - |
| 模型 ID | `MiniMax-H3` |
| 创建任务 | `POST /hailuo/v2/video_generation` |
| 查询任务 | `GET /hailuo/v2/query/video_generation/{task_id}` |
| 令牌 | `default`、`vip` 或 `svip` 分组；计费模式按量优先或按量计费 |
| 价格 | 768P \$0.05/秒，2K \$0.08/秒 |
| 能力 | 文生视频、首帧和首尾帧生视频、参考图 / 参考视频 / 参考音频生视频，输出带音轨 |
| 线路 | 基于 MiniMax 开源的 H3 模型权重独立部署，不经 MiniMax 官方 API |

## 价格

| 计费项 | 老张API | MiniMax 官方 API |
| - | -: | -: |
| 768P 输出 | \$0.05 / 秒 | \$0.08 / 秒 |
| 2K 输出 | \$0.08 / 秒 | \$0.13 / 秒 |
| 参考图（前 5 张免费） | 第 6 张起 \$0.03 / 张 | 第 6 张起 \$0.04 / 张 |

* 参考视频按素材秒数、以输出分辨率的单价计费，参考音频免费。
* 例如 768P、5 秒的文生视频费用为 \$0.25，2K、10 秒为 \$0.80。
* 失败的任务全额退回，提交阶段报错的请求不扣费。
* 官方价取自 [MiniMax 按量计费价格](https://platform.minimax.io/docs/guides/pricing-paygo)，2026 年 10 月 24 日核对。完整计费规则见 [MiniMax H3 接入文档的计费与价格](https://docs.laozhang.ai/api-capabilities/minimax-h3-video-generation.md#计费与价格)。

## 影响范围

* **想调用 MiniMax H3 的用户**：现有 `default`、`vip`、`svip` 分组的令牌可以直接使用，不需要 MiniMax 账号或新分组。
* **按次计费的令牌**：无法调用，需要把计费模式改为按量优先或按量计费。
* **其他视频模型**：Wan、Seedance 的价格与调用方式不变。

## 怎么开始

**1. 准备令牌**

在[令牌管理](https://api2.laozhang.ai/token)使用或新建一个 `default` 分组的令牌，计费模式选按量优先。

**2. 创建任务**

```bash theme={null}
curl -s -X POST "https://api.laozhang.ai/hailuo/v2/video_generation" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "MiniMax-H3",
    "content": [{ "type": "text", "text": "黄昏时分，一只橘猫在雨后的屋顶上慢慢走过，远处城市灯光亮起" }],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'
```

响应返回 `task_id`。

**3. 查询并下载**

每 10 秒查询 `GET /hailuo/v2/query/video_generation/{task_id}`，`task.status` 为 `succeeded` 后从 `task.content.url` 下载 MP4。视频链接保留 7 天。

首帧、首尾帧和参考素材的请求写法见 [MiniMax H3 视频生成 API 接入文档](https://docs.laozhang.ai/api-capabilities/minimax-h3-video-generation.md)。

## 常见问题

### 能用 `/v1/videos` 调用吗？

不能。MiniMax H3 只开放 `/hailuo/v2` 原生接口，发到 `/v1/videos` 或 `/v1/video/generations` 的请求会被拒绝，不扣费。

### 一条视频要等多久？

4–5 秒的 768P 视频通常 1 分钟左右完成，2K 和带参考视频的任务更久。高峰时段任务可能先显示 `queued`，会按提交顺序自动开始，不需要重新提交。

### 和 MiniMax 官方 API 的效果一样吗？

模型使用 MiniMax 开源的 H3 权重，文字、图片、视频、音频的输入方式与官方 MiniMax-H3 相同，分辨率提供 768P 和 2K 两档，输出带音轨。线路独立部署，所以价格单独制定，生成速度也可能和官方不同。

### 视频有水印吗？

没有可见水印。成片带立体声音轨，配乐和音效由提示词决定。

## 来源与相关链接

* [MiniMax 按量计费价格](https://platform.minimax.io/docs/guides/pricing-paygo)：MiniMax-H3 官方价格与输入素材计费规则。
* [MiniMax H3 视频生成 API 接入文档](https://docs.laozhang.ai/api-capabilities/minimax-h3-video-generation.md)：请求示例、参数、任务状态和常见错误。
* [模型与价格总表](https://docs.laozhang.ai/models.md)
* [老张API最新公告](https://docs.laozhang.ai/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.