Erased

错误码

所有错误均使用 RFC 7807（application/problem+json）格式：

{
  "type": "https://erased.ink/errors/rate-limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Free tier limit reached: 100/hour for visible. Retry after the indicated interval.",
  "retry_after": 3600
}
状态码type触发条件建议客户端处理
400.../validation请求体未通过 schema 校验。修正 JSON 后重试。
400.../unsupported-formatcontent_type 不在支持的类型清单内。转码为支持的 MIME 类型后重试。
400.../too-largesize 超过 10 MB。先压缩或缩放再上传。
401.../unauthorizedPro 接口的 API key 缺失或无效。检查 Authorization: Bearer 请求头与账户的对应关系。
402.../upgrade-required该功能需要付费套餐。在 /zh/pricing 升级，或改用更低档的模式。
402.../insufficient-creditsCredit 充值包余额不足（轻量 1 credit / 次，重量 10 credits / 次）。充值 Credit Pack，或等待月度配额刷新。
404.../not-found任务 id 未知或已过期（记录保留约 30 分钟）。重新提交任务。
405.../method-not-allowed已知路由上使用了错误的 HTTP 方法。使用 API 参考页注明的方法。
429.../rate-limited触发了小时或月度配额。按 Retry-After（秒）退避，或登录 / 升级以提高配额。
500.../server-error未捕获的内部错误。退避后重试；持续出现请反馈给我们。
502.../upstream上游服务返回错误。直接重试；配额已自动退回。
504.../upstream-timeout上游服务超时。重试；若原图无 GPU 处理需求，可考虑改用 visible / metadata 模式。