92API 接入配置与常见错误排查

本文面向 Codex、CC Switch、OpenCode、CLIProxyAPI 等兼容客户端，整理接入 92API 时最常见的配置检查项。

一、先确认三项基础配置

1. 接口地址

92API 的 OpenAI 兼容接口地址通常写为：

https://api.92api.com/v1

不要漏掉 /v1，也不要把网页管理地址当作 API 地址。

2. API Key

确认 Key 完整、没有前后空格，并且仍处于有效状态。不要在文章、截图或公开日志中展示真实 Key。

3. 模型名称

模型名称必须以 92API 控制台当前显示的名称为准。gpt-5.5 只是示例，实际不可用时应改成控制台列出的可用模型，不要自行拼写模型 ID。

二、常见错误

401 Unauthorized

常见原因：

  • API Key 错误、过期或已被停用；
  • Key 前后有空格；
  • 接口地址写错，或漏掉 /v1；
  • 修改配置后客户端没有完全重启；
  • 客户端的 provider 配置位置或 ID 不匹配。

处理顺序：重新复制 Key，检查接口地址，确认模型名称，再完全重启客户端。仍然 401 时，到 92API 后台检查 Key 状态。

403 Forbidden

通常与余额、套餐额度或当前 Key 的权限有关。先检查账户余额、有效期、分组和额度，再确认请求使用的是正确的 Key。

429 Too Many Requests

通常表示请求频率、RPM、并发数或 Session 数达到限制。关闭多余会话，等待一段时间后重试；不要在短时间内反复启动多个 Agent。

499 Client Closed Request

499 多数表示客户端主动取消请求、超时断开或本地网络波动。偶尔出现通常不代表服务端故障；频繁出现时，减少并发、检查网络和代理，并新开会话重试。

502 Bad Gateway

可能是上游服务异常、流式响应中断或当前会话状态异常。可以依次尝试：重新发送、新开会话、切换模型或稍后再试。

503 Service Unavailable

先检查模型 ID 是否正确，再确认当前 Key 绑定的渠道是否可用。也可能是 92API 或上游服务临时维护，建议查看公告后稍后重试。

Stream disconnected

优先检查客户端的 base_url 是否为完整的：

https://api.92api.com/v1

如果地址正确，再检查本地网络、代理、客户端超时设置和并发数量。流式请求被中断时，先新开会话测试，避免反复重试同一个异常连接。

三、PowerShell 连通性测试

下面只展示格式，YOUR_92API_KEY 必须在本机替换成自己的 Key，不能把真实 Key 发给别人：

$headers = @{ Authorization = "Bearer YOUR_92API_KEY" }
$body = @{ model = "控制台中的可用模型"; input = "ping" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://api.92api.com/v1/responses" -Method Post -Headers $headers -ContentType "application/json" -Body $body

如果客户端或账号不支持 responses 接口，请按照对应客户端的 OpenAI 兼容接口要求选择测试路径，不要把测试命令直接当成所有软件的固定配置。

四、快速排查清单

  1. base_url 是否为 https://api.92api.com/v1；
  2. API Key 是否完整、有效、无多余空格；
  3. Key 是否过期、停用、熔断或额度不足；
  4. 模型名是否来自 92API 当前控制台；
  5. 修改配置后是否完全重启客户端；
  6. 是否短时间内开启了过多并发会话；
  7. 本地代理、防火墙和网络是否正常；
  8. 是否为 92API 或上游服务临时异常。

五、相关入口

本文根据旧版 92API 使用说明和错误排查内容重新整理。接口、模型和后台菜单可能调整，请以 92API 当前控制台和公告为准。