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

# 计费机制

> OpenPAI 的 Token、倍率、缓存与思考扣费规则

OpenPAI 采用 **预付费 + 按 Token 计费** 模式,与 OpenAI 官方一致。
本文说明每一次调用的实际扣费如何计算。

## 计费要素

每次成功调用都会产生以下用量项:

| 项                   | 含义                                                                   |
| ------------------- | -------------------------------------------------------------------- |
| `prompt_tokens`     | 你发送给模型的输入 Token 数(含 system / messages / tools 等所有内容)。                |
| `completion_tokens` | 模型返回的输出 Token 数(可见 content)。                                         |
| `reasoning_tokens`  | 推理模型不可见的思考链 Token(仅 o3 / GPT-5 / Claude thinking / Gemini thinking)。 |
| `cached_tokens`     | 命中提示缓存的输入 Token。                                                     |

## 扣费公式

```
扣费金额 =
    (prompt_tokens     × 输入价格)
  + (completion_tokens × 输出价格)
  + (reasoning_tokens  × 输出价格)
  + (cached_tokens     × 缓存价格)
  × 用户分组倍率
```

其中:

* **输入 / 输出 / 缓存价格** 来自各模型的官方定价,以 **每百万 Token 美元单价 × OpenPAI 倍率 × 汇率** 换算到人民币。
* **用户分组倍率** 由账户所在分组决定,详见 [基础概念](/introduction/concepts)。
* **缓存价格** 通常为输入价格的 0.1× \~ 0.5×,详见 [缓存计费](/pricing/cache-billing)。

## 控制台日志示例

调用一次后,**日志** 页面会展示 Token 与扣费明细(不含 prompt / 响应内容):

| 字段                      | 示例                     |
| ----------------------- | ---------------------- |
| 模型                      | `gpt-5.5`              |
| 输入 / 输出 / 缓存 / 推理 Token | `1024 / 512 / 800 / 0` |
| 倍率                      | `1.0×`                 |
| 实际扣费                    | `¥0.0034`              |
| 请求 ID                   | `req_01ab...`          |

## 不同类型模型的计费

<AccordionGroup>
  <Accordion title="对话(Chat / Responses)">
    按 `prompt_tokens` + `completion_tokens` 扣费。
    若使用提示缓存,缓存命中部分按缓存价格结算。
  </Accordion>

  <Accordion title="推理(o3 / GPT-5 / Claude thinking)">
    `reasoning_tokens` 按输出价格 **额外** 计费(虽不可见但消耗算力)。
    控制台日志会拆分展示思考与回答 Token。
  </Accordion>

  <Accordion title="嵌入(Embeddings)">
    仅按 `prompt_tokens`(输入)计费,无输出。
  </Accordion>

  <Accordion title="图像生成(DALL·E / gpt-image-1)">
    按 **生成图数量 + 尺寸** 计费,每次调用一笔固定扣费。
  </Accordion>

  <Accordion title="音频(TTS / Whisper)">
    TTS 按 **输入字符数** 计费;Whisper 按 **音频时长(秒)** 计费。
  </Accordion>

  <Accordion title="Midjourney / Suno">
    异步任务模式,按 **任务次数 + 操作类型** 计费。失败任务不扣费。
  </Accordion>

  <Accordion title="Rerank">
    按 **(query + 所有 documents)的 Token 总和** 计费。
  </Accordion>
</AccordionGroup>

## 失败请求是否扣费

| 情况                   | 是否扣费           |
| -------------------- | -------------- |
| 4xx 客户端错误(参数错误、鉴权失败) | ❌ 不扣费          |
| 5xx 上游错误并自动重试成功      | ✅ 按成功的那次扣费     |
| 全部通道失败,客户端最终拿到 5xx   | ❌ 不扣费          |
| 流式响应中途断连             | 扣费按实际已生成 Token |
| 客户端 abort            | 扣费按上游已生成 Token |

## 余额耗尽

账户余额 ≤ 0 时,所有 **付费模型** 调用立即返回 `insufficient_quota`(HTTP 403)。
部分免费模型(如内容审核 Moderations)仍可继续使用。

## 查询消耗

* 控制台 → **日志**:逐条调用明细。
* 控制台 → **使用统计**:按日 / 模型 / 令牌聚合的消耗图表。
* API:
  * [GET /v1/dashboard/billing/usage](/api-reference/account/usage) — 时间段消耗
  * [GET /v1/dashboard/billing/subscription](/api-reference/account/balance) — 当前余额
* 响应头:每个 API 响应包含 `X-OpenPAI-Quota-Consumed` 与 `X-OpenPAI-Remaining-Quota`。

## 价格调整

* **新增模型**:以接入时官方价格折算上线。
* **官方调价**:OpenPAI 跟随上游调整,提前 24 小时在控制台公告。
* **降价 / 优惠活动**:不定期推送,以控制台 Banner 公告为准。

## 更多

<CardGroup cols={2}>
  <Card title="额度与令牌" icon="key" href="/pricing/quota">
    账户额度、令牌额度、过期与转移。
  </Card>

  <Card title="缓存计费" icon="database" href="/pricing/cache-billing">
    OpenAI / Claude / DeepSeek 提示缓存细则。
  </Card>
</CardGroup>