配额与用量预警
配额与用量预警
配额管理是控制成本、避免超额消费的关键能力。欣悦互通对 AI Token、API 调用、存储空间等资源均设置配额上限，并提供用量监控和预警机制，帮助您及时了解消耗情况并避免意外超额。
本篇介绍配额状态查看、用量统计、预警设置和超额处理四方面内容。
配额状态查看
- 进入「计费中心 → 配额管理」查看当前配额状态。
- 列表展示各类资源的配额总量、已用量、剩余量、使用率。
- 使用率以进度条展示，接近上限时变色提示：
- 0-70%：绿色
- 70-90%：黄色
- 90% 以上：红色
配额状态通过 GET /api/billing/check-quota 实时查询。常见配额项包括：
- AI Token 月度总量
- API 调用次数
- GEO 项目数量
- 存储空间容量
- AI 对话轮数
- 内容发布次数
个人/企业套餐约束
v12 新增了用户类型与套餐等级的匹配约束：
- 用户类型（
user_type）：分为个人用户和企业用户 - 套餐等级（
plan tier）：免费版、基础版、专业版、企业版 - 约束规则：系统根据
user_type × plan tier交叉校验，个人用户不能订阅企业版（enterprise）套餐。如需企业版功能，请先升级用户类型为企业用户。
该约束在创建订单和套餐切换时自动校验，违规操作将返回错误提示。
!TIP 配额按月度周期重置（每月 1 日 0 点）。月度内累计的用量不会清零，但新周期开始后配额恢复满额。
用量概览
用量概览提供 AI 资源消耗的整体统计。
- 进入「AI 中心 → 用量统计」查看概览。
- 展示当前周期的总消耗、日均消耗、环比变化。
- 支持切换时间范围（今日/本周/本月/自定义）。
用量概览通过 GET /api/ai/usage/overview 获取，包含：
- Token 消耗总量（输入 + 输出）
- 调用次数
- 估算费用
- 热门模型使用占比
用量趋势
用量趋势以折线图展示 Token 消耗随时间的变化，帮助您发现异常增长或规律性波动。
- 在用量统计页切换到「趋势」标签。
- 选择时间粒度（小时/天/周）。
- 可叠加多个模型或供应商的趋势线对比。
趋势数据通过 GET /api/ai/usage/trend 获取。
!NOTE
- 趋势图数据存在 5 分钟延迟，实时数据请参考概览页。
- 如发现某时段消耗突增，建议检查是否有异常的 Agent 或工作流在运行。
按供应商统计用量
- 在用量统计页切换到「供应商」标签。
- 展示各 AI 供应商的消耗占比饼图。
- 列表展示供应商名称、模型、调用次数、Token 消耗、费用。
供应商统计通过 GET /api/ai/usage/by-provider 获取，便于您了解不同供应商的成本占比，优化模型选择策略。
!TIP 同一任务在不同供应商的模型上可能效果相近但成本差异较大。建议定期查看供应商统计，将高频任务迁移到性价比更高的模型。
用量预警设置
预警设置帮助您在配额接近上限前收到通知，及时调整使用策略或升级套餐。
- 进入「AI 中心 → 用量统计 → 预警设置」。
- 点击「新增预警规则」。
- 配置预警条件：
- 监控指标（Token 总量/API 调用次数/存储空间）
- 阈值（如 80%、90%）
- 通知方式（站内通知/邮件/短信）
- 接收人
- 点击「确定」保存。
预警状态通过 GET /api/ai/usage/quota（配额状态）和 GET /api/ai/usage/alert（预警列表）查询。
!WARNING 建议至少设置一条 80% 阈值的预警，确保在配额耗尽前有充足时间处理。预警触发后会立即发送通知，不会重复发送同一阈值。
超额处理方式
当配额耗尽时，系统会拦截后续 API 调用，返回 403 Forbidden 并提示「配额不足」。此时有以下处理方式：
1. 升级套餐
最直接的方式是升级到更高配额的套餐，升级后配额立即恢复。
- 进入「计费中心 → 套餐方案」。
- 选择更高档套餐，点击「升级」。
- 系统按剩余周期折算差价，完成支付后配额即时恢复。
2. 购买配额包
如不想升级套餐，可购买临时配额包补充当月配额。
- 进入「计费中心 → 配额包」。
- 选择所需资源类型和数量。
- 支付后配额即时叠加到当前周期。
3. 等待周期重置
如消耗已接近月底，可选择等待下月 1 日配额重置。期间无法使用对应资源。
4. 优化使用策略
- 降低高频任务的调用频率
- 切换到成本更低的模型
- 优化 Prompt 减少 Token 消耗
- 暂停非紧急的自动化工作流
!TIP
- 配额预警通知会包含「升级套餐」和「购买配额包」的快捷链接，点击即可直接跳转处理。
- 长期超额建议升级套餐，相比反复购买配额包更经济。