메인 콘텐츠로 건너뛰기
Nano Banana 2 Lite는 Google이 가장 빠르고 저렴하다고 소개하는 Gemini 이미지 모델로, 1K 이미지, 간단한 편집, 대량 작업에 맞춰져 있습니다.

Lite 지원 범위

OpenAI 호환 경로에는 종횡비 설정이 없으며, 텍스트만 보낸 프롬프트는 1:1 이미지를 반환합니다.
Nano Banana 2 Lite로 생성한, 짙은 회색 배경에 청록색 강조가 들어간 현대적인 물류 대시보드

아래 생성 예제의 출력: 1K, 16:9. 프롬프트: Generate an image of a modern logistics dashboard on a dark gray background with cyan highlights.

Google은 Lite가 많은 참조 이미지나 멀티턴 편집에 최적화되어 있지 않다고 설명합니다. 이런 작업이나 2K·4K 출력, Google 검색 그라운딩이 필요하면 Nano Banana 2.1 또는 Nano Banana 2를, 가장 까다로운 레이아웃에는 Nano Banana Pro를 쓰세요. 다섯 가지 모델 전체 비교는 Nano Banana 개요에 있습니다.

호출 전 준비

1

API 키 발급

토큰 관리에서 토큰 생성(创建令牌) 창을 열고, 과금 방식(计费模式)을 사용량 우선(按量优先, 권장) 또는 건당 과금(按次计费)으로 설정한 뒤 생성(创建)을 클릭합니다. Lite에는 호출당 가격만 있어 사용량 과금(按量计费) 키로는 호출할 수 없습니다. 요청이 언제 과금되는지는 Nano Banana 개요의 과금 절에서 설명합니다.
2

키 설정과 의존성 설치

3

cURL용 저장 함수 추가

cURL 예제에는 jq가 필요합니다. 아래 셸 함수를 정의해 두면 Gemini 네이티브 응답의 마지막 이미지(중간 이미지가 함께 오더라도 최종 결과)를 mimeType에 맞는 확장자로 저장합니다.
응답에 이미지가 없으면 이 함수는 대신 error, promptFeedback, finishReason 필드를 출력합니다.

이미지 생성

이미지는 candidates[0].content.parts[].inlineData.data에 Base64로 들어 있고, 형식은 mimeType으로 알 수 있습니다. 두 예제 모두 이를 디코딩해 형식에 맞는 PNG, JPEG, WebP 파일로 저장합니다.

이미지 편집

parts에 지시문을 먼저, 이미지를 그 뒤에 넣습니다. 로컬 파일은 파일 형식과 일치하는 mimeType을 붙여 Base64 inlineData로 보냅니다.
큰 이미지가 셸 인자 길이 제한을 넘지 않도록 jq로 요청 본문을 만듭니다.
Lite로 많이 하는 편집은 배경 교체, 색상 변경, 스티커 추가, 간단한 변형입니다. 바뀌지 않아야 할 부분을 지시문에 분명히 쓰세요. 참조 이미지 여러 장으로 합성하려면 Nano Banana 2.1이나 Nano Banana 2를 쓰세요.

OpenAI 호환 경로 사용

앱이 이미 OpenAI SDK를 쓴다면 chat completions로 Lite를 호출할 수 있습니다. 이 경로에는 종횡비와 크기 설정이 없어서, 텍스트만 보낸 프롬프트는 1K 1:1 이미지를 반환합니다. 이미지는 message.content 안에 Base64 데이터 URL로 들어옵니다. 아래 스크립트를 nano_banana_lite_chat.py로 저장하세요.
이미지를 생성한 다음 로컬 파일을 편집합니다.

대량 호출 운영

Lite는 초안, 미리보기, 이미지를 많이 만드는 인터랙티브 앱에 잘 맞습니다. 플랫폼은 동시 요청을 제한하지 않으며, 가끔 나오는 429는 업스트림 용량 때문입니다(동시 요청과 429 참고). 운영 트래픽에서는 다음을 지키세요.
  1. 이미지마다 클라이언트를 새로 만들지 말고 HTTP 연결을 재사용합니다.
  2. 429, 5xx, 네트워크 오류는 지터를 넣은 지수 백오프로 재시도합니다.
  3. 업무 기준 타임아웃을 두고, 타임아웃이 난 요청은 재시도 전에 호출 로그를 확인해 두 번 과금되지 않게 합니다.
  4. 이미지 없는 HTTP 200 응답은 재시도하지 않습니다. 이미 과금되었고, 같은 내용을 다시 보내도 대개 또 아무것도 반환되지 않습니다.
  5. 호출마다 모델, 상태 코드, 지연 시간, 요청 시각을 기록합니다.
  6. 본격적으로 출시하기 전에 예상 최대 동시 요청 수, 일일 호출량, 입력 이미지 크기를 hi@laozhang.ai로 보내 용량을 확인합니다.

오류와 과금

  • Lite는 1K만 지원합니다. 512, 2K, 4K는 보내지 말고, 다른 크기가 필요하면 Nano Banana 2.1, Nano Banana 2, Pro를 쓰세요.
  • 크기는 K를 대문자로 쓰세요. Google은 1k처럼 소문자로 쓴 값을 거부합니다.
  • 프롬프트가 이미지를 요청하지 않았거나 안전 검사가 출력을 차단한 경우처럼, 이미지 없이 HTTP 200이 반환될 수 있습니다. 이때도 한 번 과금되므로 프롬프트나 이미지를 바꾼 뒤 다시 보내세요. Nano Banana 개요의 빈 응답 과금 피하기 절을 참고하세요.
  • HTTP 401은 키나 Authorization: Bearer 헤더가 잘못되었다는 뜻입니다. 429와 5xx는 백오프를 두고 재시도하세요.

자주 묻는 질문

Lite로 2K·4K 이미지를 받거나 Google 검색 그라운딩을 쓸 수 있나요?

둘 다 안 됩니다. Lite는 1K만 출력하고 그라운딩을 지원하지 않습니다. 필요에 따라 다음 모델을 쓰세요. 세 모델 모두 같은 요청을 받으므로 모델 ID만 바꾸면 됩니다.
  • gemini-nano-banana-2.1(Nano Banana 2.1, 호출당 $0.045): 1K~4K
  • gemini-3.1-flash-image(Nano Banana 2): 512px, 종횡비 14종, 웹·이미지 검색 그라운딩까지 필요할 때
  • gemini-3-pro-image(Nano Banana Pro): 복잡한 레이아웃을 1K~4K와 웹 검색 그라운딩으로 만들 때

Lite는 여러 이미지 합성이나 캐릭터 일관성에 적합한가요?

그다지 적합하지 않습니다. Lite는 객체 이미지를 최대 14장 받지만, Google의 참조 이미지 표에는 Lite의 캐릭터·스타일 참조 항목이 없습니다. Google은 또 Lite가 여러 참조 입력이나 멀티턴 순차 편집에 최적화되어 있지 않다고 설명합니다. Lite는 색상 변경이나 배경 조정 같은 단일 이미지 부분 편집에 맞습니다. 여러 이미지를 하나로 합치거나 연작에서 같은 인물을 유지하려면, 객체 이미지 최대 10장과 캐릭터 이미지 최대 4장을 받는 Nano Banana 2.1이나 Nano Banana 2를 쓰세요.

gemini-3.1-flash-lite-image는 안정 버전 모델 ID인가요?

네. Google 모델 페이지에 -preview 접미사 없는 안정 버전으로 올라 있습니다. 적힌 그대로 사용하세요.

Lite를 높은 동시성으로 돌릴 수 있나요?

네. 플랫폼은 동시 요청을 제한하지 않습니다. 출시 전에 위 대량 호출 운영 절에 따라 재시도와 타임아웃을 설정하고, 업스트림 용량을 확인할 수 있도록 예상 최대 부하를 고객 지원에 알려 주세요.

관련 페이지와 출처