> ## 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 中存在 **两级额度**:账户额度 与 令牌额度。所有调用同时受两者约束。

## 账户额度

账户额度是整个账号的总余额,通过 **充值** 或 **兑换码** 增加,通过 **API 调用** 减少。

* **货币单位**:人民币(¥)。
* **精度**:小数点后 6 位(支持极小金额计费)。
* **过期**:无过期时间。

## 令牌额度

每个令牌可独立配置最大可消耗额度。

| 配置    | 含义                                         |
| ----- | ------------------------------------------ |
| `-1`  | 不限制,完全使用账户余额                               |
| `100` | 该令牌累计最多消耗 ¥100,达到上限后请求返回 `quota_exhausted` |

<Tip>用于团队 / 外部协作时,强烈建议设置具体额度上限,避免单密钥失控消耗整个账户余额。</Tip>

## 双重判定

每次调用都会依次检查:

1. 令牌是否启用、是否过期、是否在模型白名单内。
2. 令牌剩余额度 ≥ 本次预估扣费(预扣)。
3. 账户余额 ≥ 本次预估扣费。
4. 调用成功后,按实际用量结算(多退少补)。

任一条件不满足都会立即返回错误,不会发起上游请求。

## 令牌过期

创建令牌时若设置了 **过期时间**:

* 过期当日 0 点起立即停用,使用该密钥的请求返回 `401 invalid_api_key`。
* 过期令牌不会自动删除,可在控制台 **延长有效期** 或 **删除归档**。

## 兑换码(Redemption Code)

兑换码是一种快速发放额度的凭证,支持:

* 单次兑换(一码一用)
* 多次兑换(N 人共享)
* 限时兑换(过期作废)

兑换时所获额度计入 **账户余额**,而非某把特定令牌。

## 退款

未消耗的额度可申请退款,规则:

* **30 天内**:支持原路退款,扣除支付渠道手续费。
* **超过 30 天**:仅支持转入其他账号或留作未来使用,不再原路退款。
* **加密货币 / 兑换码**:不支持现金退款,但可作废未消耗部分。

申请方式以控制台公告为准。

## 账户合并 / 转移

如需把 A 账号的余额转移到 B 账号:

1. 双方账号均需通过邮箱验证。
2. 通过工单提交转移申请,经人工审核(通常 1 个工作日)。
3. 大额转移(>¥5000)请走商务通道。

## 监控与告警

* **余额阈值提醒**:在 **个人设置 → 通知** 中设置低额阈值,触发后邮件提醒。
* **每日消耗摘要**:可选订阅,每日发送昨日消耗汇总。
* **企业账号 Webhook**:支持调用方自建告警系统接入。