适合谁，不适合谁
适合：能看到明确状态码客户端或日志返回 401、403、429 和响应正文。
适合：需要判断是哪一层希望区分 Key、权限、额度、频率与网络问题。
不适合：只凭截图猜原因没有请求地址、时间和正文时很难准确定位。
不适合：公开完整请求Key、正文、个人信息和内部地址必须脱敏。
开始前准备
- 状态码、响应正文、发生时间和触发操作。
- 当前客户端、Base URL、凭证类型和模型名。
- 控制台的账户状态、额度、权限和服务状态。
- 一个可重复的最小请求或客户端任务。
状态码含义由响应正文补充不同网关可能用同一状态码表达不同策略，先读取服务端返回的具体错误字段。
完整步骤
保存脱敏错误证据
记录状态码、错误代码、消息、请求时间和目标域名；删除 Key 和敏感正文。
先确认请求打到正确服务
检查 Base URL、路径和响应 Content-Type，避免把网页或代理错误当成 API 响应。
按状态码检查最可能原因
401 查凭证与请求头，403 查权限和策略，429 查频率、并发、额度与 Retry-After。
查看控制台和服务状态
确认 Key 未撤销、账户可用、模型有权限、额度正常，并查看是否有服务异常。
只改一个因素后复测
保持同一个最小任务，分别验证凭证、模型、地址或频率，避免多个变化让结果失去可比性。
先做不含密钥的网络层检查
下面只检查业务域名是否可达，不能证明 API 认证或模型调用成功。
PowerShell 可达性检查
try {
$response = Invoke-WebRequest -UseBasicParsing "https://api.xiao-he.top/" -TimeoutSec 10
$response | Select-Object StatusCode, ContentType
} catch {
$_.Exception.Message
}
# 下一步仍需回到对应客户端运行真实最小任务。不推荐
遇到 429 就无限快速重试。
建议做法
读取 Retry-After 或控制台限制，降低并发、等待后重试，并避免重复提交同一任务。
怎样判断结果是否可用？
排错要区分网络、认证、权限和限流。一次网页请求只能帮助判断网络层的一小部分。
常见问题与报错
401 Unauthorized
检查 Key 是否完整、是否撤销、请求头类型是否正确，以及客户端是否仍在使用旧凭证。
403 Forbidden
检查账户、组织、模型、功能、区域或策略权限；Key 可能有效但没有目标资源权限。
429 Too Many Requests
检查速率、并发、额度和服务端重试时间。降低请求频率，并避免立即并行重试。
连接错误却没有状态码
这通常发生在 HTTP 响应之前，检查 DNS、代理、防火墙、TLS、端口和服务状态。
完成后的检查方法
- 已保存脱敏状态码、响应正文、时间和目标地址。
- Base URL 和路径来自当前控制台说明。
- 401 已检查凭证完整性和请求头类型。
- 403 已检查账户、模型和策略权限。
- 429 已检查额度、频率、并发和重试时间。
- 每次只改变一个因素，并重复同一最小任务。
FAQ
401 是否说明 API Key 一定错误？
不一定，也可能是请求头类型、旧凭证或错误服务地址。响应正文通常会提供更多线索。
403 是否可以不停重试？
通常不应该。先解决权限或策略问题，重复相同请求不会自动获得权限。
429 应该等待多久？
优先读取 Retry-After 或服务控制台建议；没有明确值时使用逐步延长的退避并降低并发。
为什么网页能打开但客户端连接失败？
网页和 API 可能使用不同路径、代理、协议和认证；需要在客户端层继续检查。
带着状态码和脱敏响应回到当前控制台检查。
先确认地址、凭证、权限和额度，再用同一个最小任务复测。 模型、价格、额度与规则以对应业务站当前展示为准。
进入小贺API检查账户与配置