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