자주 발생하는 API 오류

가장 흔한 오류 응답의 의미와 해결 방법을 알려 드려요.

상태 의미 조치 방법
401 API 키가 없거나, 잘못되었거나, 폐기됨 X-API-Key 헤더를 확인하세요. 기존 키가 폐기되었다면 새 키를 만드세요
402 이 요청에 필요한 크레딧이 부족함 크레딧 페이지에서 팩을 구매하거나, Pro 대신 Standard를 사용하세요
400 요청이 올바르지 않음 (이미지 누락, 알 수 없는 필드, 잘못된 형식) 응답의 message 필드를 확인하세요. 문제가 무엇인지 알려 줘요
404 효과 또는 작업이 존재하지 않음 GET /v1/effects로 현재 목록을 받아 오세요
5xx 저희 쪽 또는 이미지 모델에서 문제가 발생함 다시 시도하세요. 실패한 작업은 과금되지 않아요

전체 endpoint와 필드 목록은 OpenAPI 스키마에 있어요. 오류가 계속되면 요청 시각과 endpoint를 문의 양식으로 보내 주세요.

아직 해결되지 않았나요? 문의하기. 영업일 기준 하루 안에 답변드려요.

API의 다른 글