排查 GetAPI.ONE 连接问题

先保留安全上下文

• 服务：确认使用的是 GetAPI.ONE，而不是其它 GetAPI 服务的密钥或地址。
• 时间与时区、准确客户端及版本、操作系统、端点路径、准确模型名、密钥名称/分组。
• HTTP 状态、可见错误消息，以及存在时的请求标识。
• 控制台是否有匹配的请求或使用记录。

401、缺少密钥或认证失败

1. 打开 GetAPI.ONE 密钥列表，确认目标密钥存在、已启用且未过期。
2. 从列表重新复制密钥，移除配置字段意外引入的前后空格或引号。
3. 确认客户端读取的是当前进程实际使用的环境变量/配置位置。
4. GetAPI.ONE 密钥只能与 https://www.getapi.one 或文档声明的 ONE 端点/Base URL 配套。
5. 修正配置后重启客户端，再进行一次受限重试。

• API 密钥指南

404 或请求路径不兼容

1. 确认客户端要求 Base URL 还是完整端点。来源流程中的 Codex/CCSwitch 使用 https://www.getapi.one/v1 作为 Base URL。
2. 直接调用时，将准确方法与路径和所选模型声明的端点进行对比。
3. 检查 /v1 是否缺失或重复，以及客户端是否自动拼接 /responses 或 /chat/completions。
4. 不要把 Anthropic、Gemini、图像或视频操作强行通过 OpenAI Chat 或 Responses 路径发送。

• 已声明 API 端点
• 模型端点标签

模型不存在或无权访问

1. 从当前目录复制准确模型名；许多客户端对大小写和标点敏感。
2. 确认模型明确列出客户端所用端点。
3. 确认密钥分组可见该模型，且高级限制没有排除它。
4. 刷新目录数据，不要依赖旧截图或复制列表；可用性可能变化。

额度、余额、过期或速率限制

1. 先检查密钥过期时间和剩余额度。
2. 再单独检查账号余额或套餐适用性。
3. 重试前立即查看准确模型、端点、单位和分组的实时价格。
4. 遇到速率限制时降低并发，并遵守响应中的重试提示；不要无限循环重试。

• 计费与用量指南
• 实时价格

客户端配置未生效

• Codex CLI：检查当前安装实际加载的用户级 config.toml、model_provider、env_key 拼写、base_url、wire_api 和 model。
• CCSwitch 流程：确认启用了正确目标/Provider，值已保存，并已完全重启目标。
• 如果桌面目标没有显示或接收配置，不要假设支持；改用 Codex CLI 或直接 API 客户端。

• Codex CLI 指南
• CCSwitch 兼容性边界

超时、网络或上游失败

1. 确认可以通过 HTTPS 访问 www.getapi.one，但不要把普通页面响应当成模型调用证据。
2. 检查控制台是否有匹配的失败请求，并保留其标识、时间、端点和模型。
3. 重试前判断请求是否可能已经处理，尤其是非幂等的媒体或任务操作。
4. 仅在适当时使用有上限次数与延迟的重试；持续失败则按安全上下文清单升级。

携带可复现证据求助

说明服务（GetAPI.ONE）、准确步骤、客户端/版本、时间与时区、模型、端点、脱敏密钥名称/分组、HTTP 状态、错误文本、请求标识，以及控制台是否有记录。描述一个最小复现和已经检查的项目。

• 支持渠道