常见排错

用不了？先看日志里有没有这次请求

如果日志里没有请求，先查 Base URL、API 密钥、代理和提供商（Provider）；如果日志里有失败记录，再按 401 / 403 / 404 / 429 / 522 / 524 排查。

返回文档首页打开 1A1API 控制台查看调用日志

先分流

按日志结果分成三种情况

很多问题不是模型坏了，而是请求根本没打到 1A1API。先按这三种情况分流，能少走很多弯路。

A. 日志里完全没有这次请求优先检查 Base URL、API 密钥粘贴位置、客户端代理、网络环境，以及客户端当前会话是否真的选中了这个 API 密钥或提供商（Provider）。

B. 日志里有请求但失败再按 401 / 403 / 404 / 429 / 522 / 524 排查。此时日志截图比客户端截图更有用。

C. 日志里成功但客户端没显示优先检查客户端超时、流式输出设置、中途断连、代理问题或前端显示问题。

401 Unauthorized

SDK 未读取到 API 密钥、密钥复制不完整，或自定义 HTTP 客户端没有发送 Authorization: Bearer ... 请求头，都可能导致 401。使用官方 SDK 时，请先确认环境变量已经生效；只有自己拼 HTTP 请求时，才需要手动检查 Bearer 请求头。

403 Forbidden

通常不是密钥格式错，而是当前 API 密钥没有权限或额度不可用。请检查：密钥所属分组、模型权限、余额、订阅状态、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 密钥名称或尾号和调用日志截图。

522 / 524 Cloudflare 超时

先开启流式输出、缩短上下文并拆分任务。需要切换线路时，请按客户端选择：

OpenAI SDK、Cursor、Cherry Studio、OpenCode、WorkBuddy：长任务可尝试 https://api.1a1api.top/v1。
上述 OpenAI 兼容客户端在一般网络不稳定时，也可尝试 https://1a1api.com/v1。
Claude Code：保持 https://api.1a1api.top，不要追加 /v1。
Codex：不要直接复制带 /v1 的地址，请回到 Base URL 对照确认 Responses root。

首 token 很慢

首 token 是模型开始输出前的等待时间。若明显变慢，请先检查上下文是否过长或已经爆上下文；可以新开会话、减少历史记录、压缩日志、拆分文件或降低一次性输入内容后再试。

原文搜索

常见英文报错原文

很多客户端不会直接显示 403 / 429，而是显示英文句子。可以用浏览器搜索本页原文关键词。

Selected model at capacity当前模型或上游账号繁忙。处理：稍后重试、换模型、降低并发；持续出现时联系客服并提供模型 ID 和报错时间。

No available OpenAI accounts support /responses/compact当前分组或上游账号没有 Compact 能力。普通用户请保留日志并联系管理员；管理员再按 Compact 设置路径探测能力或临时切换模式。

API key invalid / UnauthorizedSDK 未读到环境变量、密钥复制不完整或已停用；只有自定义 HTTP 请求才需要手动检查 Bearer 请求头。

model not found / model does not exist模型 ID 不在当前 API 密钥分组里。处理：从控制台或 /v1/models 复制当前可用模型 ID。

Hostname/IP does not match certificate's altnames证书域名不匹配或代理解析异常。处理：检查 Base URL、代理、DNS、证书缓存，避免填错域名。

timeout / stream interrupted长任务没有持续返回或连接中断。处理：开启 stream: true、拆分任务、缩短上下文，必要时切备用接口。

高频 FAQ

新手常见问题

我应该填 https://1a1api.top/v1 还是 https://1a1api.top？

OpenAI SDK、Cursor、Cherry Studio 通常填 https://1a1api.top/v1；Codex / Responses 类客户端通常填 root：https://1a1api.top。

为什么我有余额还是 403？

可能是当前 API 密钥所属分组没有该模型权限、订阅额度用完、余额不足，或分组没有开启 Responses / Compact / 图片生成能力。

Codex / Claude Code 不能用怎么办？

先确认 Base URL 类型：Codex 通常用 https://1a1api.top，Claude Code 通常用 https://api.1a1api.top。然后用最小请求测试模型 ID 和 API 密钥。

为什么日志里 token 数很大？

大数字可能是缓存读取或上下文缓存相关 token，不一定代表本次新输入。判断扣费先看日志里的“费用”字段。

我应该选 gpt-5.6-sol 还是 mini？

先从当前 API 密钥可用列表选择一个模型跑通；gpt-5.6-sol 只作为示例。轻量任务再按需要选择更小模型。

简版：复制就能发

问题类型：
使用工具：Codex / Claude Code / Cursor / Cherry Studio / OpenCode / WorkBuddy / 其他
模型 ID：
Base URL：
报错时间：
报错截图：
调用日志截图：
API 密钥名称或尾号（不要发送完整密钥）：

高级版：开发者排查

问题类型：
使用工具和版本：
模型 ID：
Base URL：
请求接口路径：
请求方式：GET / POST
是否开启流式输出（stream）：
HTTP 状态码：
request_id（如果有）：
客户端系统环境：
报错内容：
API 密钥名称或尾号（不要发送完整密钥）：
调用日志截图：
最小复现请求：
你已经尝试过的处理：

安全提醒：不要发送完整 API 密钥，不要把密钥发到群聊、公开截图、公开教程或代码仓库。需要排查时，只提供密钥名称、尾号或控制台截图中的脱敏信息。