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 | 서버 오류 | 잠시 후 재시도 |
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: 직접 삭제하기 전까지 보관됩니다. 결과 파일의 다운로드 URL은 7일간 유효하며, 만료 시 새 URL을 발급받을 수 있습니다.
Q: 이미지 업로드 용량 제한이 있나요?
A: 파일당 최대 50MB입니다.