MagicCore 文档
Fuel(OpenAI 兼容 API)IP-SaaS(住宅/数据中心代理)视频工厂(Video Factory)

错误码与排障

最常见的 401/403/429/5xx,各代表什么、怎么处理

IP-SaaS 的错误基本都能归到这几类:

401 Unauthorized

常见原因:

  • API Token 错误/过期
  • 代理认证信息错误

403 Forbidden

常见原因:

  • 白名单未配置或未生效
  • 当前出口 IP 不在白名单

429 Too Many Requests

常见原因:

  • 并发过高
  • 触发套餐的速率限制

处理建议:

  • 降低并发
  • 增加重试间隔
  • 升级套餐(如果是长期需求)

5xx / 连接超时

常见原因:

  • 上游波动或地区链路拥塞
  • 目标站点自身不稳定

处理建议:

  • 换一个出口(rotate)
  • 换地区/资源类型
  • 记录 request id 与时间段,方便客服定位

On this page