使用指南
常见报错与排查
先记下状态码、错误正文、时间和请求编号,再改配置。
| 现象 | 先检查什么 | 下一步 |
|---|---|---|
| 401 / Invalid token | 密钥是否完整、有无空格、是否停用或到期 | 到 API 密钥页面复制完整密钥;Bearer 后保留一个空格,不要填账号密码 |
| 403,返回站点 JSON | 错误正文是否指向权限、IP、分组或限制 | 按正文检查密钥限制;不要仅凭 403 判断余额不足 |
| 403,Cloudflare 页面或 error code: 1010 | 请求可能被站点防护拒绝,尚未到密钥校验 | 记录时间和 CF-Ray;比较浏览器与正常客户端结果,交站点管理员核查规则,不要关闭证书校验 |
| 429 | 频率、并发、余额/配额相关正文以及 Retry-After | 停止快速循环请求,按等待时间重试;减少并发;持续出现时提交请求编号 |
| 503 / 模型不可用 | 模型当前状态、模型 ID、分组和接口 | 确认 model 拼写;稍后只试一次;按目录选其他已知兼容模型;持续异常时反馈 |
| 余额不足 / quota 错误 | 账号余额和密钥自身配额都要查 | 先看钱包,再到 API 密钥编辑页看限额和到期时间 |
| 404 / 路径不存在 | 是否把完整端点误填为 Base URL,是否重复 /v1 | OpenAI 客户端用 https://api.16688.org/v1;Claude 基础地址用根域名 |
| 连接超时 / 流中断 | 网络、代理、客户端超时、是否已收到部分响应 | 先查使用日志和任务最终状态,避免重复提交已成功或仍在进行的请求 |
| HTTP 200 但没看到回答 | 实际 JSON 字段、SSE 读取方式、最终完成事件 | Chat 取 choices[].message.content;Messages 取 content[];Responses 查 delta 与 response.completed |
一分钟排查顺序
- 确认地址栏或软件实际请求目标是本站,不是 localhost:3000 或其他平台。
- 确认完整密钥来自本站,模型 ID 没有拼错,分组没有选错。
- 用最小请求发一次测试。若最小请求成功,而软件失败,优先核对软件配置和接口格式。
- 保留状态码、错误正文、请求编号及大致发生时间;截图前隐藏密钥、Cookie、账号密码和个人信息。
本站本轮核查到的示例
使用无效占位密钥发出正常 curl 请求时,本站返回 401 JSON;默认 Python 客户端的一组请求曾返回 Cloudflare 403/1010。此处只说明两种故障应分开排查,不代表所有 Python 请求都会被拒绝,也不代表修改 User-Agent 就能解决所有防护问题。