API 错误排查
先保留 HTTP 状态、脱敏后的错误信息与请求时间。状态码只是线索,以实际错误体为准;不要把 API Key 或完整私密输入发到公开评论区。
401:先检查鉴权
检查 Authorization 请求头、Bearer 格式、密钥是否已撤销,以及请求是否发到正确域名。不要把登录密码当成 API Key。
403:检查授权范围
核对账户和 Key 是否允许调用所选模型,阅读返回的权限说明;不能一律把 403 当作余额不足。
429:检查限流信息
阅读响应提示及 Retry-After(如有),降低并发并按服务要求退避。不要用无限快速重试扩大失败。
404、网络失败或超时
核对 Base URL、是否重复添加 /v1、端点与模型 ID。超时不等于请求没有处理,应结合用量记录排查,避免重复费用。
仍无法解决
准备脱敏错误、时间、客户端与配置方式,通过维护者渠道反馈。回到接入检查清单。