皮皮虾 AI排查与支持
错误码与 502 排查
保留错误信息，每次只调整一项设置。
API Key 缺失、写错、已删除，或请求头格式不正确。
确认使用 Authorization: Bearer API_KEY，重新创建并替换密钥。
当前密钥、分组或账号没有该模型的访问权限；也可能是上游拒绝。
在控制台确认模型可见、分组已授权；持续出现时保留请求 ID 联系支持。
Base URL、路径或模型名称不正确。
Base URL 通常填 /v1；模型名以控制台模型列表为准，不要照抄其他平台名称。
可能是请求频率/并发达到限制，也可能是余额不足、套餐权益或模型配额已耗尽。
先检查控制台余额、用量和套餐/分组权益；余额正常后再降低并发、稍后重试。不要只把 429 当成“限流”。
可能来自上游模型服务、短暂网络波动或请求负载异常。
对可安全重试的请求使用退避重试；图片等任务先核对任务状态，避免重复提交；若只在一个端点出现，可运行连接检测并切换推荐 URL。持续失败请提供时间、模型和请求 ID。
502 PLAYBOOK
502 Bad Gateway：按“端点 × Clash 线路”排查
502 表示请求经过某一层网关后，没有拿到可用的上游响应。它不一定是 API Key 或余额问题，也可能是当前 API 端点、Clash 代理线路、代理商节点或上游连接暂时异常。请按下面顺序定位，不要一次修改所有配置。
- 先固定客户端配置。确认客户端实际使用的 Base URL 与本页选择的一致，路径通常为
/v1；保留同一个模型、同一个 API Key 和同一个请求，方便比较结果。 - 先换 Clash 线路，再换 API 端点。在同一个 API 端点下，依次切换您购买或获取的 Clash 代理商线路；某条线路恢复后，再用这条线路测试其他 API 端点。这样可以判断问题来自线路还是入口。
- 每次切换后都看 Clash 日志。按 API 端点域名过滤请求，确认日志里出现了本次请求，并核对命中的代理组、代理商和节点。只看到 Clash 已启动，不代表客户端请求真的走了 Clash。
- 记录能稳定成功的组合。例如“
CN2 直连（推荐）+ Clash 关闭”或“默认端点+ Clash 开启 + 某代理商某节点”。后续优先使用已验证成功的组合。
关闭 Clash，保持当前 API 端点不变，重试同一个请求。
直连成功、Clash 失败：优先检查 Clash 规则、代理组或节点。
开启 Clash，保持 API 端点不变，只切换代理商提供的线路。
只有部分线路成功：使用成功线路，并在 Clash 中固定到该代理组/节点。
保持已验证的 Clash 线路不变，只切换本页提供的其他 API 端点。
只有某个端点成功：使用成功端点；其他端点可能受当前网络或入口路由影响。
至少用 2 条 Clash 线路和 2 个 API 端点交叉测试，每次只改变一个变量。
所有组合都失败：保留日志、时间、端点、线路和请求 ID，再联系支持。
如何判断请求是否真的走到了代理商
客户端没有使用 Clash。检查客户端是否支持系统代理，或开启 Clash 的 TUN 模式；同时确认应用没有单独配置直连代理。
请求进入了 Clash，但规则选择了直连，不是代理商线路。检查规则模式、代理组和域名匹配结果。
说明请求已交给代理商线路。若仍返回 502，继续切换节点或 API 端点，并记录日志中的状态、错误和时间。
检查客户端自身的超时、流式响应处理和 Base URL 路径；同时确认客户端没有发起第二个未经过 Clash 的请求。
提交排查信息：发生时间（含时区）、API 端点、Clash 代理组/代理商/节点、Clash 是否能看到请求、返回状态码、模型名称和请求 ID。请遮住 API Key、Cookie 和完整请求内容。
CONNECTIVITY & SPEED GUIDE
连通性以及速度问题排查指南
为便于快速定位问题，请按以下顺序确认；每次只调整一项配置，便于比较结果。
- 检测 URL：在 API 密钥页面确认当前使用的检测链接是否连通性良好。
- 代理节点：在 Clash 客户端及日志页面确认检测 URL 经过正确的代理节点，可通过日志查询；按您的实际连接检测结果选择可用线路。
- 分组选择：在分组设置或模型配置页面确认当前选择的分组与所使用的模型匹配。
- 渠道状态：在公开服务状态页查看对应分组的状态。首 Token 速度标准可参考渠道状态中的对话延迟；如出现速度异常，请参考本指南排查。
- 额度卡选择：在额度卡页面确认额度卡类型和剩余额度适用于当前模型或渠道。
提问时请尽量提供
说明：提供以上信息可以减少来回沟通，更快定位连通性和速度问题。
内容维护：2026-09-22 · 客户端界面可能随版本变化