오류 코드

API 오류 응답 이해하기

오류 코드
API 오류 응답 이해하기
400invalid_request

요청 매개변수가 유효하지 않거나 형식이 잘못되었습니다.

솔루션: 요청 본문을 확인하고 모든 필수 필드가 유효한 값으로 채워져 있는지 확인해 주세요.

401unauthorized

유효하지 않거나 누락된 API 키입니다.

솔루션: Authorization 헤더에 유효한 API 키를 포함하고 있는지 확인하세요.

402insufficient_credits

API 지갑에 충전된 크레딧이 부족합니다.

솔루션: 크레딧을 추가로 구매하거나 크레딧이 충전될 때까지 기다려 주세요.

404not_found

요청한 리소스(작업, 웹훅 등)를 찾을 수 없습니다.

솔루션: 리소스 ID가 정확한지 확인하세요.

429rate_limited

짧은 시간 내에 너무 많은 요청이 발생했습니다.

솔루션: 지수 백오프를 구현하고 속도 제한을 준수하세요.

500internal_error

저희 측에서 문제가 발생했습니다.

솔루션: 짧은 지연 후에 요청을 다시 시도하세요. 문제가 계속되면 지원팀에 문의하세요.

요청 제한
기본 요청 제한:
메트릭한도
분당 요청 수60
일일 요청 수10,000
동시 작업5
Nano Banana Pro API