调用排查
请求失败时的排查入口。
先保留证据
记录响应状态、错误体和 X-Request-Id。不要只截一段错误文案,也不要公开完整 API Key。
排查顺序
- 鉴权:Header 是否属于当前 API family / 调用入口,填的是用户 API Key 还是上游 Key。
- 路径:Base URL 与接口路径是否重复或缺少
/v1。 - 模型:public model id 是否在当前调用入口下开放。
- 余额与并发:余额是否大于 0,用户/网关/上游并发是否达到限制。
- 上游:结合 request_id 区分网络、限流、容量、模型不可用和超时。
- 结算:确认 usage、estimated 标记、usage log、ledger 和余额。
最后更新于