# 计费规则与信用点

来源: https://platform.lyrouter.com/ai_gateway/docs/billing
更新日期: 2026-10-14

LYRouter 用 Credits（信用点）计费：一个组织只有一个 Credits 余额，组织下所有工作空间和 API Key 共用。调用平台模型按实际用量扣 Credits，BYOK 调用按次收取平台服务费；余额降到 0 及以下时，调用返回 402。团队版和企业版另按席位订阅，到期后有 7 天宽限期，之后控制台只能查看、调用返回 402 `subscription expired; renew to continue`。

## Credits 余额

当前账号管理员在左侧「组织管理」分组的 **订阅充值** 页面查看余额：「购买充值」标签顶部的「Credits 余额」卡片显示「总 Credits」、按汇率折算的约合人民币金额，以及「充值余额」和「赠送余额」两部分。普通成员看不到这个页面，遇到余额不足或订阅到期时请联系账号管理员。

| | 充值余额 | 赠送余额 |
| --- | --- | --- |
| 来源 | 购买资源包的面额部分 | 注册与实名认证赠送、订阅套餐的「包含 Credits」、资源包中的赠送部分、核销的权益码和代金券 |
| 调用时的扣减顺序 | 赠送余额用完后再扣 | 先扣 |
| 抵扣续费、增购席位、自动续费 | 可以 | 不可以 |
| 退款 | — | 不参与退款 |

- **余额可能为负**：一次调用可能把余额扣成负数，负数记在充值余额上，充值后先补足负数部分。赠送余额不会为负。
- **订阅赠送一次到账**：订阅套餐的「包含 Credits」在支付成功时一次性计入赠送余额，不按月分批，也不随周期重置。

（截图：「购买充值」标签顶部分别显示订阅信息和 Credits 余额，余额拆成充值余额与赠送余额。）

## 调用怎样扣费

| 调用情况 | 是否扣 Credits | 扣多少 |
| --- | --- | --- |
| 平台模型调用成功 | 扣 | 按这次调用的实际用量和模型价格折算成 Credits |
| BYOK 调用成功 | 扣 | 不按 Token 扣（服务商费用由你直接与服务商结算），每次收一笔平台服务费，见 [BYOK 费用与凭证管理](https://platform.lyrouter.com/ai_gateway/docs/byok-cost) |
| 上游返回错误或连接失败 | 不扣 | — |
| 网关自动换凭证、通道或备用模型重试 | 只扣一次 | 只按最终成功的那一次计费，失败尝试不收费 |

- **价格按请求发生时冻结**：每次调用按请求发生时有效的价格和汇率计算，之后调价不会改变已经发生的调用。费用的估算方法见[调用费用与缓存计费](https://platform.lyrouter.com/ai_gateway/docs/estimate)。
- **BYOK 服务费先预留**：网关把 BYOK 请求发给服务商之前，先从余额中预留这笔服务费，调用成功才扣除，失败时退回。余额不足以支付服务费时，请求不会发往服务商，直接返回 402。

## 余额不足与 402

网关在每次调用前检查组织余额：余额大于 0 就放行，余额小于或等于 0 时返回 402 `insufficient credit balance`（`error.type` 为 `insufficient_quota`）。检查只发生在调用之前，所以最后一次放行的调用可能把余额扣成负数，之后的调用才会被拒绝。余额不足时，网关不会改走其他通道或其他计费方式。

| `error.code` | 含义 | 处理 |
| --- | --- | --- |
| `insufficient_credit_balance` | 余额已用完；或调用 BYOK 时余额不足以支付平台服务费 | 在「资源包购买」中充值 |
| `balance_missing` | 组织还没有余额记录，通常是从未充值 | 充值；已经充值仍出现时联系支持 |
| `billing_entity_missing` | 网关找不到这个 API Key 对应的计费账户 | 平台侧数据问题，联系支持 |

充值到账、余额重新大于 0 后调用即恢复，不需要更换 API Key。另外两类报错与余额不足不同：503 `billing balance is temporarily unavailable` 表示网关暂时无法确认余额，见[模型不可用](https://platform.lyrouter.com/ai_gateway/docs/unavailable)；429 中带 `credits` 的报错是配额或 Key 预算用完，见[预算、配额与限流](https://platform.lyrouter.com/ai_gateway/docs/quota)。

## 页面余额与网关判断不一致

网关按实时余额判断是否放行，而「Credits 余额」卡片在取不到实时余额时，会改用对账账本中的数据，可能滞后几分钟。此时卡片下方会提示：

> 余额来自对账账本，可能有数分钟延迟；网关按实时余额判定，可能出现「显示有余额但请求被拒」的情况。

看到这条提示时，以调用结果为准并及时充值。刚完成充值或核销时，卡片可能提示「信用点变更正在同步，当前显示的余额可能暂时延迟。」，稍后点 **刷新** 即可。总额会先于「充值余额」「赠送余额」两项更新，短时间内三者对不上属于正常现象。

## 订阅：版本、席位与试用

- **谁能订阅**：订阅面向团队版和企业版组织，团队版组织只能订阅团队版套餐，企业版组织只能订阅企业版套餐。个人版免费使用，订阅卡片显示「个人免费版」；点任意套餐会提示「个人版不支持套餐订阅」，并提供 **创建团队** 和 **创建企业** 入口。团队版需要账号管理员完成个人实名认证，企业版还需要企业实名认证，见[组织、成员与角色](https://platform.lyrouter.com/ai_gateway/docs/organization)。
- **套餐卡**：在「订阅套餐」中按「按月 / 按年」切换计费周期，每张卡显示每席位单价，以及「Credits/席位」「日志详情条数」「日志留存」「席位区间」。在卡上选择「席位数」和「订阅时长」（1～36 个计费周期），「应付金额」即单价 × 席位数 × 周期数。具体价格以卡片为准。
- **试用**：带「试用版」标签的卡片提供试用，按钮为 **免费试用**（无需付款，立即开通）或 **付费试用**（按正式套餐流程付款）。每个组织每个版本只能试用一次，团队版试用还按账号管理员本人的实名身份限一次；已试用过的卡片按钮显示「已使用试用」。试用不会自动续费。
- **席位**：组织的成员数加上尚未接受的邀请数不能超过席位数，席位满后需要先增购席位才能继续邀请，见[组织、成员与角色](https://platform.lyrouter.com/ai_gateway/docs/organization)。

订阅信息卡片的状态标签有「免费版」「试用中」「生效中」「宽限期」「订阅失效」，并显示剩余天数、有效期和席位数。下单、续费、增购席位和自动续费的操作见[购买、账单与发票](https://platform.lyrouter.com/ai_gateway/docs/orders)。

## 到期、宽限期与冻结

| 阶段 | 订阅信息卡片 | 控制台 | API 调用 |
| --- | --- | --- | --- |
| 到期前 | 「生效中」或「试用中」 | 正常 | 正常 |
| 到期后 7 天内 | 「宽限期」，**订阅充值** 页提示「订阅已进入宽限期，N 天后停用，请及时续费。」 | 正常 | 正常 |
| 宽限期结束后 | 「订阅失效」 | 各页面可以查看，不能操作 | 402 `subscription expired; renew to continue` |
| 续费成功后 | 「生效中」 | 恢复 | 恢复 |

- **冻结期间的控制台**：各页面顶部显示「订阅已过期：各页面仅可查看，请续费以恢复操作。」，点任何新增、修改或删除操作都会提示「订阅已过期，请续费后再操作。」。**订阅充值** 页面的续费、充值、核销、开票照常可用；导出日志等只读操作、修改密码、实名认证、接受邀请、消息已读也不受影响。
- **冻结期间的调用**：402 对组织下所有工作空间和 API Key 生效，BYOK 调用也一样。这时充值解决不了问题，需要续费。
- **余额保留**：冻结不会清零 Credits 余额，续费后继续使用。

## 余额与订阅提醒

当前账号管理员在 **消息中心** 点 **告警设置**，进入「告警通知」页，在「账务」类告警规则中设置提醒：

| 规则 | 触发时机 |
| --- | --- |
| 订阅到期前 7 天、订阅到期前 1 天 | 订阅周期结束前 |
| 试用到期前 7 天、试用到期前 1 天 | 试用期结束前 |
| 自动续费前 7 天、自动续费前 1 天 | 通知预计续费金额以及 Credits 是否充足 |
| 自动续费成功、自动续费失败 | 自动续费完成或失败时 |
| 订阅进入宽限期、订阅已到期 | 订阅状态变化时 |
| 信用点余额不足 | 余额低于你设置的「低余额阈值」 |
| 信用点已耗尽 | 余额耗尽时 |

## 核对实际扣费

每次调用实际扣了多少 Credits，以 **订阅充值** 页「消费明细」标签为准。表格按请求列出「请求时间」「API Key」「工作空间」「创建人」「部门」「模型」「消费 Credits」和「请求 ID」，顶部的「总消费」是所选时间范围内的合计。

- **时间范围**：默认最近 30 天，单次查询不能超过 90 天。
- **只含已结算的请求**：刚发生的调用要等结算后才出现。页面提示「消费归因仍在同步，当前分项合计可能暂时与结算总额不一致」时，稍后刷新即可。
- **定位到单次请求**：复制「请求 ID」，进入对应工作空间，在[日志](https://platform.lyrouter.com/ai_gateway/docs/logs)的搜索框中查找这次请求。
- **「创建人」是 API Key 的创建人**：多人共用一个 Key 时，看不出是谁发起的调用。需要按人核算时，为每个人分别创建 Key。

（截图：「消费明细」按请求列出时间、API Key、工作空间、创建人、部门、模型和消费 Credits。）

[用量分析](https://platform.lyrouter.com/ai_gateway/docs/analytics)和日志中的「费用」是人民币金额，用于分析用量和成本；核对账户扣了多少 Credits，请看「消费明细」。

## 常见问题

### 控制台显示还有余额，调用却返回 402，为什么？

**答：** 先看报错原文。`subscription expired; renew to continue` 表示订阅已过宽限期，需要续费，与余额无关。`insufficient credit balance` 时，网关按实时余额判断，而余额卡片可能来自滞后几分钟的对账账本（卡片下方会有提示），实际余额已经用完，请充值。

### 充值后多久可以恢复调用？

**答：** 订单变为「已完成」后 Credits 计入余额，余额重新大于 0 时调用即恢复，不需要更换 API Key。订单仍是「处理中」时请稍候；充值后仍返回 `balance_missing`，请带上订单号联系支持。

### 赠送余额可以用来续费吗？

**答：** 不可以。续费、增购席位和自动续费只能用充值余额抵扣，赠送余额只用于支付调用费用。续费前请确认充值余额足够，或直接扫码付款。