API 请求失败，如何排查？

先做三项检查

1. 确认控制台有可用额度，套餐未过期。
2. 核对客户端 Base URL，避免重复添加 /v1。
3. 发送一个简短、非敏感请求，记录错误码。

400 · 请求格式

检查必填字段和受支持的参数。先缩减为简短纯文本请求，再逐步增加可选功能。

401 · 身份验证

确认密钥属于本站、未被撤销，并用于正确的地址。清理冲突的鉴权设置，排查时不要打印密钥。

403 · 权限限制

检查账号和密钥权限。重复发送同一请求不能解决权限限制。

404 · 路径或请求标识

检查 Base URL、请求路径及账号支持的请求标识。遗漏或重复添加 /v1 都可能导致路径错误。

413 · 请求过大

减少附件和对话上下文，用更小的请求重试。

429 · 额度或速率限制

先阅读接口返回的错误信息，再检查余额、有效期和并发量，等待后再试。速率限制与额度耗尽的处理方式不同。

500 / 502 / 503 / 529 · 服务异常

服务或上游可能暂时不可用。等待后用简短请求重试，并限制重试次数。持续失败时向支持提供时间和错误码。