错误
ReWords.AI API 的错误格式、HTTP 状态码和错误码，以及哪些错误会扣费。
所有错误的结构都一样：
{ "error": { "code": "queue_full", "message": "30 jobs are already waiting. Retry in 30 seconds.", "details": {} } }| HTTP | 错误码 | 扣费 | 怎么处理 |
|---|---|---|---|
| 400 | invalid_request | 否 | 修正请求体。以 application/json 或 multipart/form-data 发送，并且只发送一种图片输入。 |
| 400 | invalid_image | 否 | 发送不超过 20 MB、8000 px 的 JPEG、PNG 或 WebP（JSON 请求体最大 28 MB），或检查 image_url 能否下载。见图片。 |
| 401 | invalid_api_key | 否 | 检查 Authorization 请求头。 |
| 402 | insufficient_balance | 否 | 购买编辑包。 |
| 402 | insufficient_ocr_balance | 否 | 购买 OCR 包，或者不带 box 把文字发给 POST /edits（那里的 OCR 免费）。 |
| 403 | image_blocked | 否 | 图片没有通过内容审核。 |
| 404 | not_found | 否 | 你的账号下不存在这个编辑 id，或者路径错误。 |
| 422 | text_not_found | 否 | 用 error.details.texts 中的框重试。 |
| 429 | rate_limited | 否 | 等待 Retry-After 秒。限制：每分钟 30 次提交、240 次查询。 |
| 503 | queue_full | 否 | 等待 Retry-After 秒。 |
| 500 | upstream_failed | 否 | 我们这边出了问题。几秒后重试。 |
请求按以下顺序检查，返回发现的第一个问题：API 密钥（401）、速率限制（429）、请求体（400 invalid_request）、
图片（400 invalid_image）、余额（402）、内容审核（403）、队列（503）、文字匹配（422）。
所以一个没有余额的账号发送了错误的请求体，会得到 400，而不是 402。
超时、网络错误和 5xx
如果 POST /edits 超时、连接断开或收到 5xx，你无法判断任务是否已创建。
用同一个 Idempotency-Key 重试：如果第一次请求确实创建了任务，你会拿回那个任务，不会被扣两次费。
POST /ocr 不需要 key——24 小时内同一张图片不会再次扣费。非 2xx 的响应可能来自代理，不一定是 JSON，
所以请先检查状态码再解析响应体。
上面的错误在你发出请求时返回。之后在处理过程中失败的任务，会在任务的 error.code 中报告
content_blocked、ai_generation_failed、timeout、upstream_failed 或 invalid_image，并且不扣费。
见结果与退款。
获取帮助
遇到无法解释的错误、任务 queued 超过 60 分钟，或者结果不对：请写信到
[email protected]，附上任务 id、UTC 时间和你收到的错误，
或者通过联系页面上的 WhatsApp 或 TikTok 联系我们。
常见问题列出了需要提供的信息。