免 KYC 从沙盒 key 到生产流量：上线前的检查清单

把集成从沙盒 key 切换到生产流量，不只是换一个 key 那么简单。真实用户请求会带来并发、延迟波动和边界情况，上线前逐项核对下面这些事项，能帮你避开大部分常见问题。

1. 确认余额与充值路径

聚合站按官方价 ×1.3 扣费，余额不足会直接导致请求失败。上线前请：

• 用生产 key 发起一次真实调用，确认扣费正常、返回成功。
• 检查账户余额是否覆盖预计的初期流量，并设置余额预警（如果平台支持）。
• 确认充值路径可用：本站支持用 Base 上的 USDC 充值，无需 KYC。提前熟悉充值到账时间，避免流量高峰时余额告急。
• 如果团队多人使用，明确谁负责监控余额和续充。

2. 核对模型别名与版本稳定性

聚合站让你用一个 API key 调用多个模型（Claude、GPT、DeepSeek、Qwen、GLM、Kimi 等）。生产环境应使用稳定的模型别名，而不是随手写的临时名称。

• 列出你实际依赖的模型，逐一确认它们在文档中的标准别名。
• 避免在代码里硬编码可能变化的模型标识；把模型名集中到配置项，便于统一调整。
• 如果业务对模型版本敏感，确认别名是否指向固定版本，或是否有版本变更通知机制。
• 在测试环境用生产别名跑一遍完整链路，确保请求参数（如 max_tokens、temperature）在各模型上行为符合预期。

3. 设计错误处理与重试策略

真实流量下，超时、限流、余额不足、模型临时不可用都可能发生。上线前应明确：

• 区分可重试错误（如超时、5xx）和不可重试错误（如参数错误、余额不足），只对前者做有限次重试。
• 为每次请求设置合理的超时时间，避免单个慢请求拖垮整体响应。
• 重试时使用指数退避，并加入随机抖动，防止重试风暴。
• 对幂等性要求高的场景，评估重试是否会导致重复计费或重复副作用。
• 记录错误日志，包含模型名、错误码和请求 ID（如果返回），便于排查。

4. 验证限流与并发行为

文档中给出的限流规则是参考值，实际表现可能因模型和时段而异。上线前：

• 在测试环境模拟预期并发，观察是否触发限流以及错误返回形式。
• 为客户端设置并发上限，避免瞬间打满配额影响其他服务。
• 如果业务有突发流量，提前评估是否需要排队或降级策略。

5. 检查监控与告警

生产环境需要能看到“正在发生什么”。至少覆盖：

• 请求成功率、平均延迟、错误类型分布。
• 余额变化和剩余额度。
• 关键业务指标（如生成失败率、用户重试率）。
• 告警渠道畅通，确保有人能及时响应。

6. 准备降级与切换方案

单一模型或单一通道故障时，业务应有退路：

• 确认同一 key 下可用的备选模型别名，并测试切换逻辑。
• 如果业务允许，设计降级策略（如切换到更轻量的模型或返回缓存结果）。
• 记录切换开关的位置和操作步骤，避免故障时手忙脚乱。

7. 复核计费与对账口径

用户按官方价 ×1.3 扣费；如果你同时贡献 key，按官方价 ×1.1（优质 ×1.2）返 USDC。上线前确认：

• 团队内部对计费倍率有统一认知，避免预算误判。
• 如果涉及贡献 key，明确返还规则和结算周期，并核对首笔返还是否正常。
• 对账时以平台账单为准，保留调用日志以便核对。

8. 最后：用小流量灰度

完成上述检查后，不要一次性切全量。先用小比例真实流量灰度，观察错误率、延迟和余额消耗，确认稳定后再逐步放量。灰度期间保持回滚能力，一旦异常可快速切回沙盒或旧通道。

上线前的 checklist 不是形式，而是把“可能出问题的地方”提前变成“已经验证过的地方”。逐项核对，能让你在真实流量到来时更从容。