16688AI使用文档
使用指南

常见报错与排查

更新于 2026 年 11 月 2 日 · 16688AI

先记下状态码、错误正文、时间和请求编号,再改配置。

现象先检查什么下一步
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,是否重复 /v1OpenAI 客户端用 https://api.16688.org/v1;Claude 基础地址用根域名
连接超时 / 流中断网络、代理、客户端超时、是否已收到部分响应先查使用日志和任务最终状态,避免重复提交已成功或仍在进行的请求
HTTP 200 但没看到回答实际 JSON 字段、SSE 读取方式、最终完成事件Chat 取 choices[].message.content;Messages 取 content[];Responses 查 delta 与 response.completed

一分钟排查顺序

  1. 确认地址栏或软件实际请求目标是本站,不是 localhost:3000 或其他平台。
  2. 确认完整密钥来自本站,模型 ID 没有拼错,分组没有选错。
  3. 用最小请求发一次测试。若最小请求成功,而软件失败,优先核对软件配置和接口格式。
  4. 保留状态码、错误正文、请求编号及大致发生时间;截图前隐藏密钥、Cookie、账号密码和个人信息。

本站本轮核查到的示例

使用无效占位密钥发出正常 curl 请求时,本站返回 401 JSON;默认 Python 客户端的一组请求曾返回 Cloudflare 403/1010。此处只说明两种故障应分开排查,不代表所有 Python 请求都会被拒绝,也不代表修改 User-Agent 就能解决所有防护问题。