오류
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).
그래서 잔액이 없는 계정이 잘못된 본문을 보내면 402가 아니라 400을 받습니다.
타임아웃, 네트워크 오류, 5xx
POST /edits가 타임아웃되거나 연결이 끊기거나 5xx를 받으면 작업이 만들어졌는지 알 수 없습니다.
같은 Idempotency-Key로 다시 시도하세요. 첫 요청이 작업을 만들었다면 그 작업을 돌려받고 두 번 차감되지 않습니다.
POST /ocr에는 키가 필요 없습니다. 24시간 안의 같은 이미지는 다시 차감되지 않습니다. 2xx가 아닌 응답은 프록시에서 와서
JSON이 아닐 수 있으니 본문을 파싱하기 전에 상태를 확인하세요.
위 오류는 요청할 때 반환됩니다. 나중에 처리 중 실패한 작업은 작업의 error.code에
content_blocked, ai_generation_failed, timeout, upstream_failed, invalid_image 중 하나를 알리며 차감되지 않습니다.
결과와 환불을 보세요.
도움 받기
설명할 수 없는 오류, 60분이 지나도 queued인 작업, 잘못된 결과가 있으면 작업 id, UTC 시각, 받은 오류를 적어
[email protected]로 보내 주시거나
문의 페이지에서 WhatsApp 또는 TikTok으로 연락해 주세요.
함께 보낼 내용은 FAQ에 정리되어 있습니다.