자주 발생하는 API 오류
가장 흔한 오류 응답의 의미와 해결 방법을 알려 드려요.
| 상태 | 의미 | 조치 방법 |
|---|---|---|
| 401 | API 키가 없거나, 잘못되었거나, 폐기됨 | X-API-Key 헤더를 확인하세요. 기존 키가 폐기되었다면 새 키를 만드세요 |
| 402 | 이 요청에 필요한 크레딧이 부족함 | 크레딧 페이지에서 팩을 구매하거나, Pro 대신 Standard를 사용하세요 |
| 400 | 요청이 올바르지 않음 (이미지 누락, 알 수 없는 필드, 잘못된 형식) | 응답의 message 필드를 확인하세요. 문제가 무엇인지 알려 줘요 |
| 404 | 효과 또는 작업이 존재하지 않음 | GET /v1/effects로 현재 목록을 받아 오세요 |
| 5xx | 저희 쪽 또는 이미지 모델에서 문제가 발생함 | 다시 시도하세요. 실패한 작업은 과금되지 않아요 |
전체 endpoint와 필드 목록은 OpenAPI 스키마에 있어요. 오류가 계속되면 요청 시각과 endpoint를 문의 양식으로 보내 주세요.
아직 해결되지 않았나요? 문의하기. 영업일 기준 하루 안에 답변드려요.