PatentFig AI 文档错误参考
错误格式、错误码与重试建议
所有错误共用一个响应壳:
{
"success": false,
"error": { "code": "INSUFFICIENT_CREDITS", "message": "…" }
}错误码
| HTTP | 错误码 | 含义 | 是否重试 |
|---|---|---|---|
| 400 | INVALID_INPUT | 参数缺失或非法,message 会指明字段 | 否——修正请求 |
| 400 | INVALID_IDEMPOTENCY_KEY | Idempotency-Key 不符合 1–255 个允许字符的要求 | 否——发送有效 key 或省略这个可选请求头 |
| 401 | UNAUTHORIZED | 密钥缺失、无效或已吊销 | 否——检查密钥 |
| 402 | INSUFFICIENT_CREDITS | 余额不足 | 充值后重试 |
| 409 | REQUEST_IN_PROGRESS | 同一幂等 key 正在处理 | 是——稍候用同一个 key 重试完全相同的请求 |
| 409 | IDEMPOTENCY_CONFLICT | 该 key 已用于不同请求 | 否——新请求请使用新 key |
| 422 | FETCH_FAILED | imageUrl 无法访问或返回错误 | 确认 URL 公网可达 |
| 429 | RATE_LIMITED | 单密钥超过 60 次/分钟 | 是——退避后重试 |
| 500 | GENERATION_FAILED | 模型或处理失败 | 是——可重试一次 |
| 500 | INTERNAL_ERROR | 服务端意外错误 | 是——可重试一次 |
重试建议
- 只有成功的调用才扣积分,重试失败的请求不会重复计费。
- 付费
POST超时而无法确认结果时,请复用同一个Idempotency-Key(不要新建 key)重试完全相同的请求。key 会保留 24 小时。 429:等待窗口重置(最长 60 秒),建议从 5 秒起指数退避。500:重试一次是合理的;持续失败通常意味着输入是模型无法处理的内容。如某个请求反复失败,请附上请求体联系 contact@patentfig.ai。