先按错误码定位，再改配置
不要只看“失败”。先找到错误码，再对照 API Key、分组、模型 ID、Base URL 和上下文长度逐项排查。
常见问题与排错
先按错误码定位；如果你看到的是一整串英文报错，再往下看“报错原文库”。
先看调用日志里有没有这次请求
很多问题不是模型坏了，而是请求根本没打到 1A1API。先按这三种情况分流，能少走很多弯路。
401 Unauthorized
先重新复制完整 API Key，确认没有多余空格、换行或省略号；再检查请求头是否是 Authorization: Bearer sk-your-api-key。Key 被删除、禁用或余额不足时也可能报错。
403 Forbidden
分组无权调用模型、余额不足、订阅过期、分组未开启对应调度能力。先确认当前 API Key 属于哪个分组，再确认该分组是否支持你填的模型 ID、Responses、Compact 或图片生成。
404 Not Found
先确认当前客户端该填 root 还是 /v1。OpenAI SDK 通常填 https://1a1api.top/v1，Codex / Responses root 通常填 https://1a1api.top，Claude Code 通常填 https://api.1a1api.top。
429 Rate Limited
请求过快、并发过高或当前服务繁忙。建议降低并发、稍后重试；如果持续出现，请把报错时间、模型 ID、Base URL、API Key 名称和日志截图发给客服处理。
522 / 524 Cloudflare 超时
请求很久没有流式返回。优先开启流式、拆分任务；如大型项目、大图生成仍遇到 CF 报错，可尝试把 Base URL 改为 https://api.1a1api.top/v1，部分地区访问该接口可能需要调整网络环境。
首 token 很慢
首 token 是模型开始输出前的等待时间。若明显变慢，请先检查上下文是否过长或已经爆上下文；可以新开会话、减少历史记录、压缩日志、拆分文件或降低一次性输入内容后再试。
常见英文报错原文
很多客户端不会直接显示 403 / 429，而是显示英文句子。可以用浏览器搜索本页原文关键词。
gpt-5.5 / GPT-5.5 测试，再按控制台可用模型修改。stream: true、拆分任务、缩短上下文，必要时切备用接口。新手最常问的 10 个问题
我应该填 https://1a1api.top/v1 还是 https://1a1api.top？
OpenAI SDK、Cursor、Cherry Studio 通常填 https://1a1api.top/v1；Codex / Responses 类客户端通常填 root：https://1a1api.top。
为什么我有余额还是 403？
可能是当前 API Key 所属分组没有该模型权限、订阅额度用完、余额不足，或分组没有开启 Responses / Compact / 图片生成能力。
Codex / Claude Code 不能用怎么办？
先确认 Base URL 类型：Codex 通常用 https://1a1api.top，Claude Code 通常用 https://api.1a1api.top。然后用最小请求测试模型 ID 和 Key。
为什么日志里 token 数很大？
大数字可能是缓存读取或上下文缓存相关 token，不一定代表本次新输入。判断扣费先看日志里的“费用”字段。
我应该选 gpt-5.5 还是 mini？
不知道选哪个先用 gpt-5.5 跑通；轻量摘要、分类、批处理再降到 mini。界面里显示 GPT-5.5 也能识别。
问题类型：
使用工具：Codex / Claude Code / Cursor / Cherry Studio / OpenCode / WorkBuddy / 其他
模型 ID：
Base URL：
报错时间：
报错截图：
调用日志截图：
API Key 名称或尾号（不要发送完整 Key）：问题类型：
使用工具和版本：
模型 ID：
Base URL：
请求端点：
请求方式：GET / POST
是否 stream：
HTTP 状态码：
request_id（如果有）：
客户端系统环境：
报错内容：
API Key 名称或尾号（不要发送完整 Key）：
调用日志截图：
最小复现请求：
你已经尝试过的处理：