Outcome
你可以诊断“Key 有效但请求仍被拒绝”等时间问题，并在轮换、续期或套餐变更时避免意外重置额度。
| Boundary | Meaning | Owner |
|---|---|---|
ApiKey.expiresAt |
凭证安全过期时间。 | Better Auth API Key lifecycle |
WorkspaceAccess.accessEndsAt |
套餐访问权的截止时间。 | Nexus Access lifecycle |
QuotaPeriod.periodEnd |
当前额度周期结束或重置时间。 | Nexus Quota lifecycle |
一次请求必须同时满足：Key enabled 且未过期、WorkspaceAccess 为 ACTIVE 且处于 Access 时间范围、QuotaPeriod 为当前 ACTIVE 周期且有足够 Available Units。
Why they remain separate
- 30–90 天 Key 安全轮换不应改变用户购买的访问周期。
- 套餐续期不应强制客户端立即更换仍安全的 Key。
- Quota 重置不应把已撤销 Credential 重新启用。
- Plan 策略更新默认影响下一 QuotaPeriod，不改写正在结算的快照。
Lifecycle effects
| Operation | Key | Access | Current QuotaPeriod |
|---|---|---|---|
| Rotate Inference Key | 新建 Key，撤销旧 Key。 | 不变。 | 不变。 |
| Suspend Access | Key 记录可以继续存在。 | SUSPENDED。 |
历史与余额保留，但新请求被拒绝。 |
| Renew Access | 不自动延长 Key TTL。 | 更新 Access 时间。 | 幂等创建或延续正确的新 Period。 |
| Change plan | 不要求换 Key。 | 绑定新 Plan。 | ACTIVE Period 保留创建时策略快照。 |
| Period rollover | 不启用过期 Key。 | 不变。 | 关闭旧 Period，创建新的额度快照。 |
Diagnose a rejected request
按顺序检查 Key 状态与 expiresAt、WorkspaceAccess 状态与 accessEndsAt、QuotaSnapshot 的 periodEnd 和 availableUnits。错误响应中的 Request ID 用于关联 Usage 与 Audit；不要只通过重新签发 Key 掩盖 Access 或 Period 问题。