why01 API 文档

主题

疑难杂症 ​

按"我看到的现象"找对应排查路径。这页和 错误码速查 互补——错误码速查按 HTTP 状态码组织，本页按实际现象组织（很多时候你拿不到清晰的状态码，只看到客户端报"连接失败"）。

第一类：完全连不通 ​

现象：客户端按钮一直转、curl 卡住不返回 ​

依次试：

  1. 本地能 ping 域名吗：
    bash
    curl -I https://s1.why01.top
    • 返 200 / 401 / 403 都说明网络通；返 Could not resolve 是 DNS 问题；卡 60 秒不返是网络封锁
  2. DNS 不通：换 DNS（114.114.114.114 / 1.1.1.1 / 8.8.8.8 任一），或试浏览器直接打开 https://s1.why01.top
  3. 企业 / 学校网络封锁：换网络试（手机热点最快验证）
  4. 本机防火墙 / 杀软拦截：临时关闭杀毒软件试

现象：浏览器能开但 curl / SDK 不通 ​

通常是证书 / TLS 版本问题：

  • 老旧 OS（Win 7 / 老 macOS）的根证书库过期，连不上现代 TLS——升级 OS 或升级 curl
  • 老旧 Python 的 ssl 包不支持新 TLS——pip install --upgrade certifi
  • 公司 MITM 代理拦截 HTTPS——配置代理证书或绕过该网络

第二类：能连但鉴权失败 ​

现象：401 Unauthorized ​

按这个顺序排（90% 的 401 是前 3 条）：

  1. Key 拼错：复制时漏字符 / 多空格 / 多换行。重新去 控制台「令牌管理」 复制，注意完整 sk- 开头到末尾
  2. 用错家的 Key：
    • why01 Key 形如 sk-xxxxxxxx
    • OpenAI 官方是 sk-...（也是 sk- 但是不同账号体系）
    • Anthropic 是 sk-ant-...
    • 三家不通用——别拿 OpenAI 官方 Key 来调本站，必报 401
  3. 请求头格式错：必须是 Authorization: Bearer sk-xxx（注意 Bearer 后单空格），不是 Authorization: sk-xxx
  4. Key 已过期 / 已禁用：控制台「令牌管理」 检查
  5. 变量名用错：
    • Claude Code 用 ANTHROPIC_AUTH_TOKEN（不是 ANTHROPIC_API_KEY！）
    • Codex 按 config.toml 的 env_key 字段读
    • OpenAI SDK 默认读 OPENAI_API_KEY

现象：返 403 Forbidden ​

不是鉴权失败而是"权限不够"——通常是用户组没接入这个模型或这个端点。联系客服 升级用户组。

第三类：能调通但模型不对 ​

现象：返 404 model not found ​

最常见原因：

  1. 模型名拼错：注意大小写、版本日期后缀（如 claude-sonnet-4-6 不是 claude-sonnet-4-6）
  2. 模型不在你用户组：去 控制台模型页 看实际可见列表，按那里的名字填
  3. 上游临时下线：前一天还能用今天突然 404，多半是上游商下线了——换同类模型或等 联系客服 切渠道

现象：模型能调，但响应明显比官方差 ​

渠道差异是聚合网关的固有性质——同一个模型名背后可能是不同上游商的 API。表现：

  • 输出风格略有不同
  • 偶尔不识别小众参数（如 logit_bias、response_format 部分细节）
  • 流式分包节奏略有不同

如果你的应用对上游一致性有强要求（比如做 benchmark 对比），本站不是合适选择，建议直接用官方账号。

现象：返回内容明显被截断 ​

finish_reason 看：

  • length —— 命中 max_tokens 上限。你设的 max_tokens 太小或没设。最简单：把 max_tokens 调大或干脆不传（让模型按上下文窗口决定）
  • content_filter —— 触发上游内容过滤。换措辞 / 换上游
  • stop —— 模型自己判定输出完整结束（不是截断）

第四类：性能问题 ​

现象：响应慢（10 秒以上） ​

排查顺序：

  1. 是不是流式可以解决体感：长输出本身就慢（模型每秒生成 ~50-100 token，500 token 输出最少 5 秒）。开流式让用户边看边等
  2. 看 prompt 长度：超长 prompt（>10k token）首字延迟显著上升——这是模型本身的特性，不是网关问题
  3. 检查路由：s1.why01.top 直连东京源站（2026-05-11 已撤 CF 代理），不会有 cf-ray 响应头。如果你的 curl -I https://s1.why01.top 看到 cf-ray，说明被中间代理 / CDN 截胡了，这是异常情况，联系客服 报路由问题
  4. 特定时段慢：北美下午（北京时间凌晨）上游负载高，普遍变慢。错峰调用

现象：偶发超时 / 连接被重置 ​

  • 客户端 timeout 太短：把 HTTP timeout 调到 ≥ 5 分钟（见 进阶技巧 § 调用更稳）
  • 运营商劫持 / 不稳：换 4G 热点试，确认是不是本地网络问题
  • 批量调用并发太高：触发限速，加 backoff

现象：流式输出突然断在中间 ​

  • 客户端 SSE timeout 太短（默认 idle 60 秒断）
  • 上游推理过程超过 idle 阈值（长 reasoning 模型常见）
  • 解决：客户端把 idle timeout 调大；或减小 max_tokens / 减小 reasoning effort

第五类：账户 / 余额相关 ​

现象：明明充值了余额没变 ​

  • 充值后 30 秒内不显示是正常的，刷新一下
  • 超过 5 分钟仍未到账：截图支付宝订单（订单号 + 金额 + 时间）+ 你的账户邮箱 联系客服
  • 千万不要重复支付——确认到账前最多再支付一次（避免反复扣款）

现象：调用返 402 Insufficient Balance 但控制台显示有余额 ​

罕见。按这个顺序排：

  1. 强刷控制台「钱包」页（Ctrl+Shift+R）确认实际余额
  2. 看是不是用了单 Key 额度上限——令牌额度跑完了，账户余额还在但这个 Key 不能用了
  3. 这都不是 → 联系客服 报你的 Key 前 8 位 + 调用时间

现象：消耗速度异常快 ​

去 控制台「日志」 按时间过滤，找到大消耗那条调用看：

  • model —— 是不是误用了贵模型（比如 client SDK 默认参数把模型从 gpt-5-mini 换成了 gpt-5）
  • prompt_tokens —— 是不是 prompt 出乎意料的大（比如 agent 把整个 node_modules/ 读进 context 了）
  • completion_tokens —— 是不是没设 max_tokens 模型放飞自我

不是任何上述问题、且日志条数也对得上：恭喜 / 抱歉，这就是你应用本身的真实消耗。

现象：日志里出现"我没发过的调用" ​

最大可能是 Key 泄露。立即按 Key 泄露 SOP 处理，并 联系客服 评估申诉。

第六类：客户端 / CLI 相关 ​

Claude Code 上下文过大 / 对话异常 ​

长会话或一次性塞太多文件给 claude，上下文逼近窗口上限时会出现"突然不响应/输出割裂/丢工具调用"等表现。处理顺序：

  1. /context：先看当前 token 占用，确认是不是真的爆了
  2. /clear：清空对话开新会话（最有效），关键文件后面再喂
  3. 关闭自动压缩（如果你不希望 claude 自己截短上下文）：settings.json 加 "env": { "DISABLE_AUTOCOMPACT": "1" }
  4. 拆任务：一次只让它处理一个目录 / 一个模块，别让它一上来就 grep 整个 repo

Claude Code 常用调试命令

  • /status — 当前会话状态、模型、用户组
  • /context — 当前对话上下文 token 占用
  • /clear — 清空当前会话开新一轮
  • /cost — 本次会话累计花费

Claude Code 自动更新弹窗 / 升级后变难用 ​

某些 Claude Code 版本会有回归 bug（典型表现：内容被无故截断、tool use 失效）。如果你跑得稳的版本被自动升上去后变差：

临时关闭自动更新（保留当前版本）：

~/.claude/settings.json 加：

json
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

或全局环境变量：

bash
export DISABLE_AUTOUPDATER=1
powershell
$Env:DISABLE_AUTOUPDATER = "1"

降级回稳定版：

bash
npm install -g @anthropic-ai/claude-code@<已知稳定版本号>

具体哪个版本号稳定看官方 Issues 区当时的反馈，本站不固化版本号（会随时间过时）。

排查前先做的环境变量自检 ​

很多 CLI 报错本质是环境变量没生效。先快速看一下：

powershell
Get-ChildItem Env: | Where-Object { $_.Name -like "*ANTHROPIC*" -or $_.Name -like "*OPENAI*" -or $_.Name -like "*GEMINI*" }
bash
env | grep -E "ANTHROPIC|OPENAI|GEMINI"

应该看到 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN（Claude Code）或对应工具的环境变量。空 = 没生效，重启终端让 shell 重新加载 rc 文件。

Claude Code 启动报 401 ​

见 Claude Code § 常见问题 § 401。最常见是把 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN 设了。

Codex 启动跳到登录页 / 死循环 ​

config.toml 里的 model_provider 没指向你定义的自定义 provider，回退到了内建 OpenAI 官方流程。检查 ~/.codex/config.toml 顶级 model_provider = "why01"（或你自定义的名字）。

Gemini CLI 一直要登录 Google 账号 ​

部分 CLI 版本对自定义 endpoint 支持差。直接走 Gemini API 路径 B——用 OpenAI 兼容客户端调 Gemini 模型。

Cherry Studio 测试连接通过但聊天 401 ​

部分客户端的"测试连接"调的是 /v1/models，鉴权方式与 chat 端点略不同。直接发一条对话验证比测试按钮更可靠。

Cursor 已配自定义 endpoint 但仍走官方 OpenAI ​

Cursor 的设置里有多处可能覆盖：「Models」「OpenAI API」「Use Custom OpenAI Endpoint」等。全部检查一遍，特别是 Override OpenAI Base URL 必须勾上 + 填了 URL。

还是没解决？ ​

联系客服，按以下格式整理信息：

现象：（一句话描述你看到什么）
复现频率：稳定 / 偶发 / 一次
我的 Key 前 8 位：sk-xxxxxxxx（不要发完整 Key）
调用时间：2026-05-04 14:30 北京时间
模型：gpt-5-mini
端点：POST /v1/chat/completions
HTTP 状态码：（如果有）
错误响应体：（如果有，截图或粘文本）
我已经试过：（按本页排过哪几条）

控制台「日志」对应记录截图发客服更直观。