---
description: "按实际使用量计费的定价详情，海外模型约官方直连 25%–35%。"
---

# 定价详情

在问 OneAPI 按实际使用量计费，不同模型类型采用不同的计费策略。所有价格均为人民币（CNY）。

## 与官方定价对比

以下对比表在文档构建时根据平台实时价格动态生成：

<PriceComparison />

::: tip 价格说明
- OpenAI、Claude、Gemini 等海外模型通过在问平台调用，价格约为官方直连的 **25%–35%**
- DeepSeek、GLM 等国产模型价格与官方基本持平
- 所有模型均支持缓存命中优惠，实际使用成本更低
:::

## 计费单位

| 模型类型 | 计费方式 | 单价单位 |
|---------|---------|---------|
| Chat、Embeddings | 按 Token | 元 / 百万 Token |
| 图片生成、音乐生成 | 按次 | 元 / 次 |
| 语音转写、语音合成 | 按时长 | 元 / 秒 |

## Chat 与 Embeddings 模型

按输入和输出的 Token 数分别计费。

**计算公式：**

```
费用 = 输入 Token × 输入单价 / 1,000,000
     + 缓存命中 Token × 缓存命中单价 / 1,000,000
     + 输出 Token × 输出单价 / 1,000,000
```

### 缓存命中优惠

当输入内容与历史请求的前缀匹配时，命中缓存的部分按折扣价计费：

```
缓存命中单价 = 输入单价 × 缓存折扣比例
```

例如，某模型输入单价 5.00 元/百万 Token，缓存折扣比例为 0.8，则缓存命中部分单价为 4.00 元/百万 Token。

各模型的缓存折扣比例不同，详见[模型目录](./models.md)。

::: tip 什么是缓存命中？
API 提供商会对相同前缀的输入内容进行缓存。当你的请求与历史请求共享相同的系统提示词或上下文前缀时，匹配部分的 Token 会按折扣价计费，通常可节省 20%–90% 的输入成本。
:::

## 图片生成模型

按调用次数计费，每次调用消耗固定费用（由模型配置决定），与图片分辨率和复杂度无关。

## 音乐生成模型

按被接受的生成请求次数计费，单价由所选模型决定。一次请求即使返回多个候选片段，也只按该次请求计费一次；后续查询生成状态不额外收费。详见[音乐生成文档](./api-music.md)。

## 语音转写模型

按音频实际时长计费，向上取整到秒。

## 语音合成模型

按实际生成的音频时长计费，向上取整到秒。输入字符数会作为用量信息返回，但当前不作为计费单位。

## 费用预估与余额检查

系统会在请求发送前预估费用，确保余额充足：

1. **余额为零**：直接返回 `402 Insufficient balance`
2. **小额请求**（< 100KB）：根据请求内容长度估算 Token 数，与余额对比
3. **中额请求**（100KB–10MB）：仅做内容长度估算
4. **大额请求**（> 10MB）：仅检查是否满足最低余额门槛

预估采用保守策略，允许一定的透支，因为最终计费以上游返回的实际 Token 用量为准。

::: warning 余额不足
余额不足时，API 返回 HTTP 402 状态码。建议在业务侧做好余额检查和充值提醒，避免影响用户体验。
:::

## 充值优惠

| 充值金额 | 赠送比例 |
|---------|---------|
| ¥100 – ¥300 | +10% |
| ¥300 – ¥1,000 | +15% |
| ¥1,000 以上 | +20% |

赠送金额在充值成功后自动添加到账户余额。

## 邀请奖励

通过邀请码注册的用户，首次充值享受 **9 折** 优惠。邀请人可获得被邀请人每次充值金额的 **10%** 作为奖励（每个被邀请人最多奖励 3 次）。

## 定价查看

所有模型的实时定价可在[模型目录](./models.md)页面查看，也可以在工作台的模型列表中查看。定价数据在文档构建时自动从 API 拉取，与平台保持一致。