用途:在 OpenRouter 集成上线前或运维评审时,逐项校验生产就绪度,覆盖安全、可靠性、可观测性、成本管理与运维流程。它验证已有集成,不负责搭建集成。
前提:需将 OpenRouter API Key(sk-or-v1-...)导出为 OPENROUTER_API_KEY;需 curl 与 jq 运行验证脚本;如需把检查项转为 CI 自动化检查,需 Python 3.8+;CI 中需有密钥扫描工具(gitleaks 或 trufflehog)。
主要能力:安全清单检查密钥是否存于密钥管理器、90 天轮换、按密钥设置额度(GET /api/v1/auth/key 的 .data.limit)、CI 密钥扫描、仅用 HTTPS;可靠性清单检查回退链(models 数组加 route: "fallback")、SDK max_retries=3、timeout=30.0、主模型熔断、每个请求设置 max_tokens;可观测性清单检查结构化日志(含 generation_id、model、latency、tokens、cost)、错误率告警(5 分钟内超 5%)、按模型的 P50/P95 延迟、通过 GET /api/v1/generation?id= 跟踪每日成本、额度余额告警。
使用方式:逐项完成三份清单并记录验证命令或 API 端点;运行上线前验证脚本,检查认证、额度限制、主模型可用性、一次真实测试请求和硬编码密钥扫描;修复所有 FAIL 并重跑,直到输出 READY FOR PRODUCTION,再按企业注意事项接入 CI 作为部署前门禁。
输出:一份通过/失败的上线前验证报告(五项编号检查、结果汇总与最终结论)、三部分就绪清单、硬编码密钥扫描结果。
限制:资料未提供具体收费、价格或平台支持范围;脚本中的模型名与阈值仅为示例,需按实际环境调整。