中转站报错 API Error 502 origin_bad_gateway 排查步骤
如果 API 中转站突然返回 Cloudflare 生成的 502 origin_bad_gateway，先打开中转站状态页。目标模型或线路近期记录全红时，通常不是本地配置问题，而是中转站源站或上游号池已经无法正常响应，应立即联系在线客服或站长。
错误摘要
报错：API Error 502、Error 502: Bad gateway、error_name: origin_bad_gateway、cloudflare_error: true。先看中转站状态页；如果目标模型或线路全红，停止反复改 Key 和重试，直接联系在线客服或站长确认号池与恢复时间。
API 中转站返回：
API Error: 502
Error 502: Bad gateway
error_name: origin_bad_gateway
cloudflare_error: true
owner_action_required: true
The origin web server returned an invalid or incomplete response to Cloudflare.这个错误是什么意思
origin_bad_gateway 表示请求已经到达 Cloudflare，但中转站源站返回了无效或不完整的响应。报错里的 owner_action_required: true 也说明需要网站运营方检查源站，而不是让 API 用户反复修改本地配置。
在 API 中转站场景里，如果服务此前正常、端点仍能 PING 通，但目标模型或线路的状态记录突然全红，常见实际原因是中转站上游号池已经耗尽、失效或无法调度。网关没有把内部故障转换成清晰的业务错误，最终对外暴露成 Cloudflare 502。
但不要反过来认定所有 502 都是号池问题。只有状态页、服务商公告或站长反馈能进一步确认具体根因。
先看中转站状态页
打开中转站自己的状态页，找到正在使用的模型和线路：
- 如果近期记录几乎全红，说明是服务端持续故障。停止反复换 Key、重装客户端或高频重试，立即找在线客服或站长处理。
- 如果只有一个模型全红，先临时切换到状态正常的模型，同时询问该模型号池何时恢复。
- 如果所有模型和线路都全红，中转站整体上游或源站很可能已经不可用，准备临时切换备用服务商。
- 如果状态页全绿，才继续检查 Base URL、模型名和本地网络，并用最小请求复测。
联系客服或站长时提供什么
把完整报错、出错时间、模型名、Base URL 域名、状态页截图、ray_id 或 instance 一起发给客服或站长，直接询问该模型号池是否已耗尽、是否有备用线路以及预计恢复时间。
一句话结论
API 中转站出现 502 origin_bad_gateway 时先看状态页，目标模型或线路全红就停止本地折腾，立即联系在线客服或站长确认号池和恢复时间。