Lite 지원 범위
OpenAI 호환 경로에는 종횡비 설정이 없으며, 텍스트만 보낸 프롬프트는 1:1 이미지를 반환합니다.

아래 생성 예제의 출력: 1K, 16:9. 프롬프트: Generate an image of a modern logistics dashboard on a dark gray background with cyan highlights.
호출 전 준비
1
API 키 발급
토큰 관리에서 토큰 생성(创建令牌) 창을 열고, 과금 방식(计费模式)을 사용량 우선(按量优先, 권장) 또는 건당 과금(按次计费)으로 설정한 뒤 생성(创建)을 클릭합니다. Lite에는 호출당 가격만 있어 사용량 과금(按量计费) 키로는 호출할 수 없습니다. 요청이 언제 과금되는지는 Nano Banana 개요의 과금 절에서 설명합니다.
2
키 설정과 의존성 설치
3
cURL용 저장 함수 추가
cURL 예제에는 응답에 이미지가 없으면 이 함수는 대신
jq가 필요합니다. 아래 셸 함수를 정의해 두면 Gemini 네이티브 응답의 마지막 이미지(중간 이미지가 함께 오더라도 최종 결과)를 mimeType에 맞는 확장자로 저장합니다.error, promptFeedback, finishReason 필드를 출력합니다.이미지 생성
- cURL
- Python
candidates[0].content.parts[].inlineData.data에 Base64로 들어 있고, 형식은 mimeType으로 알 수 있습니다. 두 예제 모두 이를 디코딩해 형식에 맞는 PNG, JPEG, WebP 파일로 저장합니다.
이미지 편집
parts에 지시문을 먼저, 이미지를 그 뒤에 넣습니다. 로컬 파일은 파일 형식과 일치하는 mimeType을 붙여 Base64 inlineData로 보냅니다.
- cURL
- Python
큰 이미지가 셸 인자 길이 제한을 넘지 않도록
jq로 요청 본문을 만듭니다.OpenAI 호환 경로 사용
앱이 이미 OpenAI SDK를 쓴다면 chat completions로 Lite를 호출할 수 있습니다. 이 경로에는 종횡비와 크기 설정이 없어서, 텍스트만 보낸 프롬프트는 1K 1:1 이미지를 반환합니다. 이미지는message.content 안에 Base64 데이터 URL로 들어옵니다.
아래 스크립트를 nano_banana_lite_chat.py로 저장하세요.
대량 호출 운영
Lite는 초안, 미리보기, 이미지를 많이 만드는 인터랙티브 앱에 잘 맞습니다. 플랫폼은 동시 요청을 제한하지 않으며, 가끔 나오는429는 업스트림 용량 때문입니다(동시 요청과 429 참고). 운영 트래픽에서는 다음을 지키세요.
- 이미지마다 클라이언트를 새로 만들지 말고 HTTP 연결을 재사용합니다.
- 429, 5xx, 네트워크 오류는 지터를 넣은 지수 백오프로 재시도합니다.
- 업무 기준 타임아웃을 두고, 타임아웃이 난 요청은 재시도 전에 호출 로그를 확인해 두 번 과금되지 않게 합니다.
- 이미지 없는 HTTP 200 응답은 재시도하지 않습니다. 이미 과금되었고, 같은 내용을 다시 보내도 대개 또 아무것도 반환되지 않습니다.
- 호출마다 모델, 상태 코드, 지연 시간, 요청 시각을 기록합니다.
- 본격적으로 출시하기 전에 예상 최대 동시 요청 수, 일일 호출량, 입력 이미지 크기를 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~4Kgemini-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를 높은 동시성으로 돌릴 수 있나요?
네. 플랫폼은 동시 요청을 제한하지 않습니다. 출시 전에 위 대량 호출 운영 절에 따라 재시도와 타임아웃을 설정하고, 업스트림 용량을 확인할 수 있도록 예상 최대 부하를 고객 지원에 알려 주세요.관련 페이지와 출처
- Nano Banana 개요 — 5종 모델, 두 프로토콜, 과금 비교
- Nano Banana 2.1 — 더 낮은 가격으로 1K~4K 출력, 종횡비 14종, 검색 그라운딩
- Nano Banana 2 — 512px~4K 출력, 종횡비 14종, 검색 그라운딩
- Nano Banana Pro — 복잡한 레이아웃과 브랜드 핵심 에셋
- Standard 편집 —
gemini-2.5-flash-image편집을 옮길 때 Lite와 Nano Banana 2 중 고르기 - Google: Nano Banana image generation — Gemini 3.1 Flash Lite Image의 크기, 종횡비, 참조 이미지 제한
- Google: Gemini 3.1 Flash Lite Image 모델 페이지 — 안정 모델 ID와 지원 기능
- 호출 로그 — 요청별 상태와 청구 금액 확인