请求失败排查

这页按排查顺序列出最常见的请求失败原因。建议按编号顺序逐项排查，跳过哪一步都可能导致错过了真正的问题。

1. 检查 API Key

• Key 是否完整复制。
• 是否带了多余空格。
• 是否已经删除或失效。
• 请求头是否是 Authorization: Bearer <你的 API Key>。

不要把完整 API Key 发给支持、贴到聊天软件，或出现在截图里。

2. 检查 Base URL

• 是否填入 Arqel 的 API 地址。
• 是否漏掉 /v1。
• 是否把 /chat/completions 重复填进只需要 Base URL 的字段。
• 工具是否仍在使用默认 Provider。

3. 检查模型名

• 模型名是否拼写正确。
• 当前 Key 是否允许调用该模型。
• 如果不确定，先到 Arqel 控制台查看当前可用模型名，再复制到工具配置里。

4. 检查余额和用量

• 账户余额是否足够。
• Key 是否达到限制。
• 是否存在自动化 Agent 循环调用。

5. 检查上游状态

模型能力、速度、可用性仍由上游状态决定。如果上游波动，可能出现超时、限流或临时失败。

6. 检查工具协议和产品入口

如果 Agent 工具有回复但 Arqel 控制台没有记录，通常不是 API Key 本身的问题。继续检查：

• 当前工具是否支持 Arqel 提供的请求格式。
• CLI、桌面 App、IDE 插件、网页端是否读取同一套配置。
• CC Switch 写入的配置是否作用于正在运行的工具。
• 工具是否需要重启、Reload Window 或重新打开终端。

不要把 Cursor、Claude Code、Codex、Hermes Agent 的配置方式互相套用。

API 调用示例只用于后端、脚本、SDK 或深度排障。新手接 Agent 时，优先在 Agent 里做只读测试，再看 Arqel 控制台记录。

仍然无法解决

请记录：

• 请求时间。
• 使用的 Key 名称，不要发送完整 Key。
• Base URL。
• 模型名。
• 错误信息和状态码。
• 使用的工具或 SDK。
• 工具或 SDK 版本。
• 请求 ID / trace ID（如果响应或控制台提供）。

不要发送完整 API Key、私有提示词、客户数据或未打码截图。

也可以到交流群询问：

交流群：<群号待填写>

提问时请尽量说明：操作系统、工具名称、配置方式、错误截图、请求时间，以及 Arqel 控制台是否有请求记录。