Source: https://01router.com/zh/docs/models/minimax-h3-max-turbo/quote
Base URL: https://01router.com/api/v1

# MiniMax H3 Max Turbo · 报价

报价分为接口报价和前端报价：接口报价由服务端返回当前可用渠道的费用；前端报价读取 models 的价格与计费字段，在用户修改参数时本地计算。

`POST /api/v1/quote`

公开接口 · 无需 API Key

## 接口报价

调用 POST /api/v1/quote，Content-Type 为 application/json，无需 API Key，不扣费。适用于视频、图片和音频生成；聊天费用按 Token 用量计算，见下方前端报价。

请求体必填 model（模型 slug）和 input（生成参数对象）。input 按模型声明填写 prompt、duration、resolution、num_images 等字段，与创建生成任务使用相同参数。可选 provider 指定渠道；可选 project 使用项目 ID 解析项目自定义模型名。省略 provider 时查询自动路由候选渠道。

响应 providers 列出可用渠道的 provider、unit、quantity、price_usd、original_price_usd 和 credits，按后端路由顺序排列，第一项是自动路由首选；unavailable 列出被排除的渠道及原因；请求失败或没有可用渠道时处理接口返回的 error。音频按用量计费时返回预留费用，最终按实际用量结算。

## 前端报价

获取价格：请求 GET /api/v1/models，可用 type 筛选模型类型。普通目录从 data 中选择 model.slug，再从 providers 中选择渠道，读取该渠道的 prices、params、billing。项目目录请求 GET /api/v1/models?project=项目ID，直接读取 data 中模型的这些字段。接口公开读取，无需 API Key；跨域访问项目目录遵守项目域名限制。

### 价格字段说明

| 字段 | 含义与用法 |
| --- | --- |
| prices[].unit | 计费单位：request 按次，second 按秒，image 按张，kchar 按千字符，input_token / output_token 按百万 Token。 |
| prices[].priceMicros | 该规则的单价，单位为微美元。1,000,000 微美元 = 1 美元；Token 单价对应一百万 Token。 |
| prices[].conditions | 价格适用条件，例如分辨率、mode。Token 的 min_input_tokens 表示输入长度档位，缺省为 0。 |
| params | 所选渠道支持的输入参数。用 type、required、default、options、min/max 等信息校验输入并补默认值。 |
| billing.modelParams | 模型层的参数定义，先用它校验用户输入。 |
| billing.upstreamParams | 可选。存在时，最终按这里的参数定义校验并补默认值。 |
| billing.characterBilling | 可选的字符计费设置：fields 为统计字段，block 为向上取整的字符块大小，minimum 为最低计费字符数。 |
| billing.metering | 可选的音频用量计费设置：outputTokenHold 为预留输出 Token 数；providerCost=true 表示最终费用需上游报告。 |
| billing.creditsPerUsd | 每美元对应的积分数。为 null 时不计算网关积分；不要用 prices[].credits 乘数量。 |
| billing.priceScope | gateway 为网关售价；project 为已含项目倍率的转售价，不要再乘项目倍率。 |
| billing.version | 当前计算规则版本为 1；遇到不支持的版本应停止报价并刷新目录。 |
| billing.unavailableReason | 非空表示当前配置不能报价，应展示原因，不要按免费处理。 |
| prices[].originalMicros | 可选的原价，只用于展示，不参与实付金额计算。 |
| fromMicros | 模型列表的起步单价，不是本次请求总价；具体报价应读取所选渠道的 prices。 |
| maxMicros | 模型列表的最高单价（单位见 maxUnit），不是本次请求总价；具体报价应读取所选渠道的 prices。 |

### 计算前：准备输入并选择价格

准备参数：billing.version=1 为当前计算契约；billing.unavailableReason 非空时不可报价。先按 billing.modelParams 校验模型输入，再按渠道 params 的类型、required、default、options、min/max 等约束校验并补默认值；存在 billing.upstreamParams 时，以其校验结果和默认值作为最终输入。渠道或上游不支持的字段，只有其值等于模型默认值时才忽略，否则报错。mode 根据最终参数定义中的 image/images 字段是否有值推导为 image 或 text，不直接使用用户指定的 mode。

按次、秒、图片和字符计费时，用最终输入匹配 prices[].conditions：条件全部满足才可选，比较时将值转为字符串；匹配规则中条件最多的一条优先，同等条件数量保留接口返回顺序。Token 按下文的输入长度档位选价。

### 按次数（request）

每次请求计 1 次。总微美元 = round(priceMicros × 1)，与时长、图片数量无关。例：单价 20,000 微美元，一次请求为 0.02 美元。

### 按秒数（second）

数量取补齐默认值后的 input.duration，最低为 1；未提供且模型也无默认值时按 1 计算。总微美元 = round(priceMicros × 秒数)。例：每秒 50,000 微美元，生成 8 秒为 0.40 美元。时长仍须符合模型参数限制。

### 按图片数量（image）

数量取补齐默认值后的 input.num_images，最低为 1；未提供且模型也无默认值时按 1 计算。总微美元 = round(priceMicros × 图片数)。例：每张 30,000 微美元，生成 4 张为 0.12 美元。图片数量仍须符合模型参数限制。

### 按字符数（kchar）

单价对应 1,000 个字符。默认统计 input.prompt 的 JavaScript 字符串 length（不是字节数，部分 emoji 会计为 2）。配置了 billing.characterBilling 时，合计 fields 指定字段的字符串长度；有 block 时先向上取整到 block 的倍数，再应用 minimum，最终至少 1 个字符。

计费数量 = 计费字符数 / 1,000；总微美元 = round(priceMicros × 计费数量)。例：统计到 1,200 个字符，block=1,000、minimum=1,000，则按 2,000 个字符计费；每千字符 100,000 微美元时，总价为 0.20 美元。没有 block 时不要自行按整千字符取整。

### 按 Token（input_token / output_token）

输入、输出分别计价，单价均对应 1,000,000 Token。使用输入 Token 数，分别从两类规则中选择 min_input_tokens 不超过该数量且阈值最高的一条；未设置阈值视为 0，同档位保留返回顺序。输出价格的档位也由输入 Token 数决定。

总微美元 = ceil(输入单价 × 输入 Token 数 / 1,000,000 + 输出单价 × 输出 Token 数 / 1,000,000)。先合计再向上取整，不要分别取整。例：输入单价 1,000,000、输出单价 2,000,000 微美元，输入 1,000 Token、输出 500 Token，总价为 0.002 美元。Token 数不是字符数；未知输出量只能预估。

音频预留：存在 billing.metering 时，先将 prompt 与 style_instructions 拼接，取 UTF-8 字节数 + 256 作为输入 Token 估值，输出 Token 取 outputTokenHold，再用上述 Token 公式计算预留金额。最终按真实用量结算；providerCost=true 时以所需的上游费用报告进行结算。

### 统一换算：美元与积分

上面的 round 表示四舍五入到整数微美元（Math.round），ceil 表示向上取整（Math.ceil）。美元金额 = 总微美元 / 1,000,000。billing.creditsPerUsd 非空时，积分 = max(1, ceil(美元金额 × creditsPerUsd - 1e-9))；最低 1 积分，减去 1e-9 用于避免浮点误差造成多扣。例：0.40 美元、每美元 250 积分，对应 100 积分。

### 项目售价与报价有效性

项目售价：billing.priceScope=project 的单价已包含项目售价倍率，不要重复加价；billing.creditsPerUsd=null，不能据此计算网关扣费积分。POST /quote 即使携带 project，返回的仍是网关收费价和积分，不包含项目转售加价。

一致性：同一价格配置、指定渠道与输入下，按上述规则计算可与后端保持一致。目录缓存 60 秒，更新价格后需重新获取；前端报价不锁价。自动路由还考虑渠道可用性、优先级和熔断，本地最低价不保证实际成交价。参数不合法、版本不支持或无匹配价格时应提示无法报价，不能显示为免费。

## 输入参数

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [   "minimax-h3-max-turbo" ] |
| input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 |  |
| provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 |  |
| project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 |  |
| input.prompt | string | yes |  |  |
| input.image_url | string<uri> | no | Optional start image (image-to-video) |  |
| input.end_image_url | string<uri> | no |  |  |
| input.audio_url | string<uri> | no | Audio the video follows (2–15 s) |  |
| input.duration | integer | no |  | default: 5; min: 5; max: 15 |
| input.resolution | enum | no |  | default: "768p"; options: [   "480p",   "768p",   "1080p" ] |
| input.aspect_ratio | enum | no |  | default: "16:9"; options: [   "16:9",   "9:16",   "1:1",   "4:3",   "3:4",   "21:9" ] |

## 输出字段

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 |  |
| input | object | — | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 |  |
| providers | array | — | 按后端路由顺序排列的可用供应商，包含 unit、quantity、price_usd、original_price_usd 和 credits；第一项是自动路由首选。 |  |
| unavailable | array | — | 无法处理此请求的供应商及原因。 |  |

## 示例代码（伪代码）

### 接口报价

```text
参数.model ← 所选模型 slug
参数.input ← prompt、duration、resolution 等生成参数
参数.provider ← 指定渠道（可选）
参数.project ← 项目 ID（可选）
结果 ← POST /api/v1/quote，JSON 请求体为参数
请求失败时展示 error；成功时展示 providers 中的 price_usd、credits
用 unavailable 说明被排除渠道的原因
```

### 前端报价

```text
目录 ← GET /api/v1/models（项目目录加 project 参数）
价格来源 ← 所选模型的 providers 中的渠道；项目目录直接选模型
输入 ← 按 params 和 billing 校验、补默认值、推导 mode
规则 ← 从 prices 中匹配 conditions；Token 计费则选择上下文档位
数量 ← 按 unit 与输入字段计算；音频预留参考 billing.metering
总微美元 ← 普通计费 round(单价 × 数量)，Token 计费 ceil(输入费用 + 输出费用)
美元 ← 总微美元 / 1,000,000
积分 ← creditsPerUsd 非空时 max(1, ceil(美元 × creditsPerUsd - 1e-9))
展示报价；用户修改参数时重新本地计算，无需请求 /quote
```