← सभी गाइड पर लौटें

59API 请求失败排障：401、402、429 与 5xx 怎么修

AI API 请求失败，先看 HTTP 状态码，再读响应中的错误类型和消息。401 通常指向认证，402 可能涉及计费，429 表示请求受到限制，5xx 则需要检查服务端与上游。不同接口的错误含义可能存在差异，应结合响应正文判断。

排障前：先保存一份最小失败样本

记录请求时间、模型标识、接口路径、状态码和脱敏后的错误正文；如果响应提供请求 ID，也一起保存。日志中的密钥、用户输入和个人信息应隐藏，避免直接分享完整请求。

• 检查地址：59API 的基础地址为 https://api.59api.com。使用 OpenAI SDK 调用兼容接口时，通常将 base_url 配为 https://api.59api.com/v1，注意最终路径不要重复出现 /v1/v1。
• 缩小请求：暂时关闭流式输出和工具调用，只发一句简短提示，并使用账户当前可用的模型标识。最小请求成功后，再逐项恢复原配置。
• 对比环境：核对终端、IDE、容器和部署平台实际读取的配置。修改环境变量后，重启对应进程。

401：密钥存在，为什么仍然认证失败？

优先检查密钥是否属于当前服务、是否已撤销，以及复制时是否混入空格或换行。OpenAI 兼容接口通常使用 Authorization: Bearer 密钥；采用其他协议的客户端，应按对应接入说明设置认证。

如果本地成功、服务器失败，检查部署平台是否仍保存旧密钥，或请求是否发到了其他服务地址。不要把密钥写进 URL、公开仓库或工单截图。若已泄露，应撤销并重新生成。401 不适合自动重试，先修正认证信息。

402：先确认计费问题，再决定是否充值

402 常被 API 服务用于表示余额、额度或支付条件不足，但具体含义以错误正文为准。检查账户余额、当前模型的计费规则，以及是否存在账户或密钥额度限制。

如果充值后仍失败，先确认充值账户与密钥所属账户一致，并核对余额是否到账。测试时缩短输入、降低最大输出 token 数，有助于判断是否与单次请求的可用额度有关；这不能替代补足余额。

429：区分请求频率、token 限额与并发限制

429 不一定意味着每秒请求太多。长上下文、大量输出和多个并行任务，也可能触发 token 或并发限制。先读错误消息及限流响应头，再调整对应指标。

• 有 Retry-After：按响应指定的等待时间重试；该字段可能是秒数，也可能是 HTTP 日期。
• 没有等待提示：可从约 1、2、4 秒的退避开始，加入随机延迟，并设置最大重试次数和总超时。
• 持续触发：用队列限制并发；若触及 token 限额，则缩短上下文、降低输出上限或分批处理。

检查 SDK 是否已经自动重试。外层代码再次叠加多轮重试，会放大请求量，让限流更难恢复。

5xx：判断是否可以重试，尤其注意流式输出

500 通常表示服务端内部错误；502、503、504 常涉及网关、服务暂不可用或上游超时，但状态码无法单独证明故障发生在哪一层。保存响应正文和请求 ID，再观察是否仅某个模型或某类请求失败。

对偶发错误，可在退避后有限重试，例如最多额外尝试两次。若长请求更易超时，减少上下文和输出长度，并核对客户端超时配置。不要只延长超时而忽略服务端返回的错误。

流式请求即使返回 HTTP 200，也可能中途报错或断开。需要同时捕获流中的错误事件。已收到部分输出时，重新发送可能产生重复内容和额外费用；涉及工具执行时，还要避免重复触发外部操作。

常见问题：SDK 能用，Claude Code 或 Codex 为什么失败？

不同客户端可能读取不同的地址、密钥和模型配置，也可能使用不同协议。分别核对 Claude Code、Codex 与 OpenAI SDK 的实际配置，确认客户端支持对应模型及接口。若最小文本请求成功，只有工具调用或特定功能失败，应进一步检查功能兼容性和请求参数。

提交问题时，附上客户端及版本、失败时间与时区、模型、脱敏错误和请求 ID。这些信息比单独一张“请求失败”截图更有助于定位。

低成本接入，也要控制失败请求的成本

59API 提供按量付费的 Claude、GPT 模型接入，采用原生官方品质模型，不降级，并兼容 Claude Code、Codex 和 OpenAI SDK，适合关注调用成本的开发者。比较费用时，也应计入重试、长上下文和重复生成的消耗；推荐返利则以平台当前规则为准。

如果你正准备接入，可以注册 59API，用少量余额先验证一个模型和一条完整调用链，再逐步扩大用量。

मूल्य · दस्तावेज़