Errors & FAQ
에러 처리 방법과 자주 묻는 질문입니다.
HTTP 상태 코드
| 코드 | 설명 | 해결 방법 |
|---|---|---|
| 400 | 잘못된 요청 | 요청 형식 확인. Database API "Access denied"는 API 키 팀과 DB 소유 팀 불일치 |
| 401 | 인증 실패 | API 키 확인 |
| 402 | 크레딧 부족 | 크레딧 충전 |
| 403 | 접근 거부 | API 키 활성화 상태 확인 |
| 422 | 입력 검증 실패 | 파라미터 타입/값 확인 (예: output_format은 jpeg/png/webp만 허용) |
| 429 | 요청 한도 초과 | Retry-After 헤더 확인. limit_type으로 IP/API키 제한 구분 |
| 500 | 서버 오류 | 잠시 후 재시도 |
403 storage_quota_exceeded
팀이 스토리지 쿼터를 초과한 상태에서 POST /files/upload-url을 호출하면 이 코드와 함께 403이 반환됩니다. 파일당 50MB 제한과는 별개이며, 파일 총량이 한도를 넘으면 새 업로드가 거부됩니다. AI 예측 결과물은 이 쿼터로 차단되지 않습니다. 응답 형태: { "detail": { "code": "storage_quota_exceeded", "message": "..." } }. message는 바이트/파일 개수 한도 중 어느 쪽을 넘었는지에 따라 문구가 달라지는 설명 문자열입니다(변동될 수 있음) — 분기 처리는 항상 code 값으로 하세요. 해결: 오래된 파일 삭제(사용량은 GET /files/storage로 확인) 또는 상위 플랜 업그레이드.
Rate Limits
API 키별 제한 (기본값)
분당 요청 수
60/min
시간당 요청 수
1,000/hour
동시 예측 수
10 concurrent
IP 기반 제한 (글로벌, API 키와 별개)
IP 분당
30/min
IP 시간당
1,000/hour
IP 제한은 동일 IP의 모든 API 키 요청이 합산됩니다. Prediction 폴링도 포함되므로 대량 요청 시 주의하세요.
자주 묻는 질문
Q: API 키를 분실했어요
A: 대시보드에서 기존 키를 삭제하고 새 키를 발급받으세요.
Q: 크레딧이 부족해요
A: 다음날 UTC 자정에 무료 크레딧이 충전됩니다. 또는 충전 코드를 사용하세요.
Q: 예측이 실패했는데 크레딧이 차감됐어요
A: 실패한 예측의 크레딧은 자동으로 환불됩니다.
Q: 결과 파일은 얼마나 보관되나요?
A: 팀 플랜에 따라 보관 기간이 다릅니다 (Free 30일, Pro 365일, Team·Enterprise 무기한). 결과 파일의 다운로드 URL은 기본 7일간 유효하며, 만료돼도 파일 자체는 삭제되지 않습니다 — POST /files/sign으로 언제든 새 URL을 재발급받을 수 있습니다.
Q: 이미지 업로드 용량 제한이 있나요?
A: 파일당 최대 50MB입니다.