본문으로 건너뛰기
Cheapest Imagen
가이드

오류

Cheapest Imagen API가 반환하는 모든 HTTP 상태와 오류 코드의 의미, 과금 여부, 다음에 할 일을 안내합니다.

오류의 형식은 OpenAI와 같습니다.

{
  "error": {
    "message": "Not enough credits for this request.",
    "type": "invalid_request_error",
    "param": null,
    "code": "insufficient_credits"
  }
}

모든 응답에는 x-request-id 헤더가 포함됩니다. 지원팀에 문의할 때 함께 알려 주세요.

상태code의미해결 방법
400missing_required_parameter필수 필드가 없습니다param에 표시된 필드를 추가하세요
400invalid_value필드에 허용되지 않는 값이 있습니다param에 표시된 필드를 수정하세요
400unsupported_parameter해당 필드를 사용할 수 없거나 이 모델에서 지원하지 않습니다(예: SVG 출력이 없는 모델의 svg)필드를 제거하거나 해당 기능이 있는 모델을 선택하세요
400model_not_found모델이 없거나 열려 있지 않습니다GET /v1/models에 있는 모델을 사용하세요
400moderation_blocked프롬프트 또는 이미지가 콘텐츠 검사에서 거부되었습니다프롬프트를 바꾸세요. Nano Banana 안정 채널(-1k, -2k, -4k)을 제외하고 과금되지 않습니다
401invalid_api_key키가 없거나 올바르지 않습니다Authorization 헤더를 확인하세요
402insufficient_credits크레딧이 부족합니다충전하세요
403account_suspended계정 또는 키가 비활성화되었습니다지원팀에 문의하세요
409idempotency_key_in_useIdempotency-Key가 이미 사용되었습니다첫 요청이 끝나기를 기다리거나 새 키를 사용하세요
413request_too_large요청 또는 이미지가 너무 큽니다더 작은 이미지를 보내거나 이미지 수를 줄이세요
429rate_limit_exceeded1분에 300건을 넘는 요청속도를 줄이고 다시 시도하세요
429concurrency_limit_exceeded동시에 50건을 넘는 요청진행 중인 요청 하나가 끝나기를 기다리세요
429moderation_paused1시간 동안 거부된 요청이 10건을 넘음1시간 기다리세요
502upstream_error이미지를 생성하지 못했습니다다시 시도하세요. 과금되지 않습니다
504upstream_timeout생성이 420초를 넘겼습니다다시 시도하세요. 과금되지 않습니다

과금되는 경우

받은 이미지에 대해서만 과금됩니다. 실패, 시간 초과, 거부된 요청은 비용이 들지 않습니다. 예외는 Nano Banana 안정 채널(-1k, -2k, -4k)로, 콘텐츠 사유로 거부된 이미지에도 요금이 부과됩니다. 제공 업체가 해당 이미지에 요금을 청구하기 때문입니다.

이 페이지의 내용