错误排查

先读错误正文，再检查地址、密钥、模型与分组。状态码只是排查的起点。

先做四项检查

1. 地址： 是否使用 API 地址，有没有重复 /v1 或填成文档链接？
2. 密钥： 是否完整、活跃且未过期，工具是否读取了正确环境变量？
3. 分组与模型： 模型名是否正确，分组是否支持该模型和请求协议？
4. 记录与状态： 使用记录是否出现对应请求，渠道状态是否异常？

401：认证失败

常见原因是未填写密钥、复制了缩略密钥、密钥已失效，或工具仍在读取另一套认证配置。

重新从密钥页复制完整密钥，确认请求带有正确认证信息。使用环境变量时，检查设置变量与启动工具是否在同一个终端。

403：没有访问权限

检查当前分组与目标模型的访问权限，以及密钥配置的限制。具体原因以错误正文为准；反复重试通常无法解决权限问题。

404：路径或模型不正确

先核对最终请求地址。Responses 示例应请求 https://acode.ink/v1/responses。

若路径正确，再确认所选分组是否支持该接口、模型名称是否存在。model not found 也可能通过其他 HTTP 状态码返回，应以错误类型为准。

429：限流或额度相关限制

阅读错误中的具体原因。可能是请求频率、并发、上游限制，或额度类问题。

降低并发，停止密集重试；如果响应提供 Retry-After，按其建议等待。额度问题应先检查账户和密钥限制。

5xx：网关或上游错误

查看渠道状态和站点公告，记录错误时间与请求 ID。短暂错误可适当等待后重试，持续出现时提供信息给客服。

不要因为某个模型报错，就在未核对协议的情况下随意更换模型。

超时或连接失败

核对域名、网络与代理设置，再检查客户端超时参数。连接拒绝、DNS 错误和响应超时不是同一种问题，保留原始错误信息有助于定位。

超时不等于没有受理

请求可能已经发到上游。先查看使用记录或已有结果，再决定是否重试，尤其不要自动重复提交高消耗任务。

配置修改后没有生效

重启对应工具，检查终端环境变量、CC Switch 当前服务商、配置 profile，以及项目配置是否覆盖了用户配置。

如果工具运行在容器、远程机器或 IDE 中，确认配置和密钥是在实际运行程序的环境里设置的。

整理一份有效的问题反馈

工具与版本：
发生时间与时区：
Base URL：
模型名称：
HTTP 状态码：
错误正文：
请求 ID（如有）：
已经尝试的步骤：

不要附上完整 API 密钥、登录密码或未经检查的账户截图。通过主站公开的联系方式提交反馈。