计费规则与信用点
LYRouter 用 Credits（信用点）计费：一个组织只有一个 Credits 余额，组织下所有工作空间和 API Key 共用。调用平台模型按实际用量扣 Credits，BYOK 调用按次收取平台服务费；余额降到 0 及以下时，调用返回 402。团队版和企业版另按席位订阅，到期后有 7 天宽限期，之后控制台只能查看、调用返回 402 subscription expired; renew to continue。
Credits 余额
当前账号管理员在左侧「组织管理」分组的 订阅充值 页面查看余额：「购买充值」标签顶部的「Credits 余额」卡片显示「总 Credits」、按汇率折算的约合人民币金额，以及「充值余额」和「赠送余额」两部分。普通成员看不到这个页面，遇到余额不足或订阅到期时请联系账号管理员。
| 充值余额 | 赠送余额 | |
|---|---|---|
| 来源 | 购买资源包的面额部分 | 注册与实名认证赠送、订阅套餐的「包含 Credits」、资源包中的赠送部分、核销的权益码和代金券 |
| 调用时的扣减顺序 | 赠送余额用完后再扣 | 先扣 |
| 抵扣续费、增购席位、自动续费 | 可以 | 不可以 |
| 退款 | — | 不参与退款 |
- 余额可能为负：一次调用可能把余额扣成负数，负数记在充值余额上，充值后先补足负数部分。赠送余额不会为负。
- 订阅赠送一次到账：订阅套餐的「包含 Credits」在支付成功时一次性计入赠送余额，不按月分批，也不随周期重置。
图 1：「购买充值」标签顶部分别显示订阅信息和 Credits 余额，余额拆成充值余额与赠送余额。 截图为演示数据，点击图片可查看原图。
调用怎样扣费
| 调用情况 | 是否扣 Credits | 扣多少 |
|---|---|---|
| 平台模型调用成功 | 扣 | 按这次调用的实际用量和模型价格折算成 Credits |
| BYOK 调用成功 | 扣 | 不按 Token 扣（服务商费用由你直接与服务商结算），每次收一笔平台服务费，见 BYOK 费用与凭证管理 |
| 上游返回错误或连接失败 | 不扣 | — |
| 网关自动换凭证、通道或备用模型重试 | 只扣一次 | 只按最终成功的那一次计费，失败尝试不收费 |
- 价格按请求发生时冻结：每次调用按请求发生时有效的价格和汇率计算，之后调价不会改变已经发生的调用。费用的估算方法见调用费用与缓存计费。
- 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 表示网关暂时无法确认余额，见模型不可用；429 中带 credits 的报错是配额或 Key 预算用完，见预算、配额与限流。
页面余额与网关判断不一致
网关按实时余额判断是否放行，而「Credits 余额」卡片在取不到实时余额时，会改用对账账本中的数据，可能滞后几分钟。此时卡片下方会提示：
余额来自对账账本，可能有数分钟延迟；网关按实时余额判定，可能出现「显示有余额但请求被拒」的情况。
看到这条提示时，以调用结果为准并及时充值。刚完成充值或核销时，卡片可能提示「信用点变更正在同步，当前显示的余额可能暂时延迟。」，稍后点 刷新 即可。总额会先于「充值余额」「赠送余额」两项更新，短时间内三者对不上属于正常现象。
订阅：版本、席位与试用
- 谁能订阅：订阅面向团队版和企业版组织，团队版组织只能订阅团队版套餐，企业版组织只能订阅企业版套餐。个人版免费使用，订阅卡片显示「个人免费版」；点任意套餐会提示「个人版不支持套餐订阅」，并提供 创建团队 和 创建企业 入口。团队版需要账号管理员完成个人实名认证，企业版还需要企业实名认证，见组织、成员与角色。
- 套餐卡：在「订阅套餐」中按「按月 / 按年」切换计费周期，每张卡显示每席位单价，以及「Credits/席位」「日志详情条数」「日志留存」「席位区间」。在卡上选择「席位数」和「订阅时长」（1～36 个计费周期），「应付金额」即单价 × 席位数 × 周期数。具体价格以卡片为准。
- 试用：带「试用版」标签的卡片提供试用，按钮为 免费试用（无需付款，立即开通）或 付费试用（按正式套餐流程付款）。每个组织每个版本只能试用一次，团队版试用还按账号管理员本人的实名身份限一次；已试用过的卡片按钮显示「已使用试用」。试用不会自动续费。
- 席位：组织的成员数加上尚未接受的邀请数不能超过席位数，席位满后需要先增购席位才能继续邀请，见组织、成员与角色。
订阅信息卡片的状态标签有「免费版」「试用中」「生效中」「宽限期」「订阅失效」，并显示剩余天数、有效期和席位数。下单、续费、增购席位和自动续费的操作见购买、账单与发票。
到期、宽限期与冻结
| 阶段 | 订阅信息卡片 | 控制台 | 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」，进入对应工作空间，在日志的搜索框中查找这次请求。
- 「创建人」是 API Key 的创建人：多人共用一个 Key 时，看不出是谁发起的调用。需要按人核算时，为每个人分别创建 Key。
图 2：「消费明细」按请求列出时间、API Key、工作空间、创建人、部门、模型和消费 Credits。 截图为演示数据，点击图片可查看原图。
用量分析和日志中的「费用」是人民币金额，用于分析用量和成本；核对账户扣了多少 Credits，请看「消费明细」。
常见问题
控制台显示还有余额，调用却返回 402，为什么？
答： 先看报错原文。subscription expired; renew to continue 表示订阅已过宽限期，需要续费，与余额无关。insufficient credit balance 时，网关按实时余额判断，而余额卡片可能来自滞后几分钟的对账账本（卡片下方会有提示），实际余额已经用完，请充值。
充值后多久可以恢复调用？
答： 订单变为「已完成」后 Credits 计入余额，余额重新大于 0 时调用即恢复，不需要更换 API Key。订单仍是「处理中」时请稍候；充值后仍返回 balance_missing，请带上订单号联系支持。
赠送余额可以用来续费吗？
答： 不可以。续费、增购席位和自动续费只能用充值余额抵扣，赠送余额只用于支付调用费用。续费前请确认充值余额足够，或直接扫码付款。