401：API Key 错误、认证失败
可能原因：API Key 填错、少复制了一段、配置没有生效。
怎么做：重新复制完整 API Key，检查环境变量或请求头。
是否联系客服：确认 API Key 无误仍失败时需要。
常见错误说明
遇到报错时，可以先按下面说明排查。处理不了再联系客服。
403：API Key 被禁用或无权限
可能原因：API Key 当前不可用，或请求的模型不在可用范围内。
怎么做：先到查询页确认状态，再检查模型配置。
是否联系客服：状态不是 active 时需要。
429：请求太频繁或并发过高
可能原因：短时间请求过多，或多个客户端同时使用同一个 API Key。
怎么做：降低频率，稍等后重试。
是否联系客服：长期无法恢复时需要。
500：服务内部异常
可能原因：服务处理请求时遇到异常。
怎么做：稍后重试，并保留发生时间。
是否联系客服：重复出现时需要。
502：上游异常
可能原因：上游临时不可用或返回异常。
怎么做：稍等一会儿再试，避免连续重试同一请求。
是否联系客服：持续出现时需要。
503：服务繁忙
可能原因：当前请求较多，系统暂时繁忙。
怎么做：等待几分钟后重试。
是否联系客服：长时间不可用时需要。
504：请求超时
可能原因：任务较长，或网络链路响应慢。
怎么做：缩短输入内容或降低输出长度后重试。
是否联系客服：简单请求也频繁超时时需要。
余额不足
可能原因：API Key 余额不足以继续请求。
怎么做：请购买充值码并完成兑换后继续使用。
是否联系客服：充值失败或余额没有变化时需要。