PatentFig AI 文档错误参考
错误格式、错误码与重试建议
所有错误共用一个响应壳:
{
"success": false,
"error": { "code": "INSUFFICIENT_CREDITS", "message": "…" }
}错误码
| HTTP | 错误码 | 含义 | 是否重试 |
|---|---|---|---|
| 400 | INVALID_INPUT | 参数缺失或非法,message 会指明字段 | 否——修正请求 |
| 401 | UNAUTHORIZED | 密钥缺失、无效或已吊销 | 否——检查密钥 |
| 402 | INSUFFICIENT_CREDITS | 余额不足 | 充值后重试 |
| 422 | FETCH_FAILED | imageUrl 无法访问或返回错误 | 确认 URL 公网可达 |
| 429 | RATE_LIMITED | 单密钥超过 60 次/分钟 | 是——退避后重试 |
| 500 | GENERATION_FAILED | 模型或处理失败 | 是——可重试一次 |
| 500 | INTERNAL_ERROR | 服务端意外错误 | 是——可重试一次 |
重试建议
- 只有成功的调用才扣积分,重试失败的请求不会重复计费。
429:等待窗口重置(最长 60 秒),建议从 5 秒起指数退避。500:重试一次是合理的;持续失败通常意味着输入是模型无法处理的内容。如某个请求反复失败,请附上请求体联系 contact@patentfig.ai。