AI API 常见错误与排查方法
先看 HTTP 状态和结构化错误，再核对端点、密钥、模型、额度和请求格式；不要把所有错误都当作网络问题。
400 与 404：先检查请求
400 通常需要检查 JSON、参数和接口能力；404 需要确认基础地址、路径与模型名称。修改配置前保留一份脱敏后的最小请求。
401 与 403：检查鉴权和权限
确认 Authorization 使用 Bearer 格式、密钥未被禁用，并且该密钥允许访问目标模型。不要通过公开渠道发送完整密钥求助。
429：区分额度不足和限流
读取错误码和提示，判断是账户额度、密钥额度、并发限制还是短时频率限制。只有短时限流适合带抖动的退避重试。
5xx 与连接错误：控制重试
对尚未开始输出的幂等请求可以有限重试；对已开始流式输出或可能已经产生结果的请求，应避免盲目重复，以免出现重复计算和费用。