Gemini Nano Banana 2.1 사용법: 이미지 생성·편집과 API 마이그레이션
구글은 2026년 10월 6일 Gemini Nano Banana 2.1을 정식 출시했습니다. API 모델 ID는 gemini-nano-banana-2.1입니다. 기존 Nano Banana 2인 gemini-3.1-flash-image를 잇는 고효율 이미지 생성·대화형 편집 모델로, 1K·2K·4K 출력, 파노라마 비율, 글자 표현, 여러 참조 이미지의 일관성을 보강했습니다.
이번 변화는 단순히 모델 이름이 하나 늘어난 것이 아닙니다. 기존 모델은 사용 중단 날짜가 발표되지는 않았지만 공식적으로 사용 중단 예정 상태가 됐고, 구글은 새 프로젝트와 기존 프로젝트 모두 Nano Banana 2.1로 옮길 것을 안내합니다. 이 글에서는 무엇이 달라졌는지, Google AI Studio와 API에서 어디부터 시작하는지, 기존 코드를 어떻게 바꾸는지, 비용과 한계를 무엇까지 확인해야 하는지 순서대로 정리합니다.
먼저 보는 핵심 요약
- 출시 상태: 2026년 10월 6일 GA, 안정 버전 모델 ID는
gemini-nano-banana-2.1 - 입력과 출력: 텍스트·이미지·동영상·PDF를 입력하고 이미지와 텍스트를 출력
- 해상도: 기본 1K, 필요에 따라 2K·4K 지정
- 다중 참조: 전체 참조 이미지는 최대 14장, 그중 인물 일관성은 최대 4명, 사물 충실도는 최대 10개를 대상으로 안내
- 검색 근거: Google 웹 검색과 이미지 검색을 이용한 그라운딩 지원
- 마이그레이션:
gemini-3.1-flash-image는 사용 중단 예정이며 종료일은 아직 발표되지 않음 - API 무료 티어: 공식 가격표에서 Nano Banana 2.1의 무료 티어는 제공되지 않음
Nano Banana 2.1에서 실제로 달라진 점
1. 긴 가로 이미지와 고해상도 작업이 더 명확해졌습니다
지원 출력은 1K, 2K, 4K이며 기본값은 1K입니다. 특히 1:4, 4:1, 1:8, 8:1 같은 매우 긴 파노라마 비율에서 2K와 4K 출력의 타일 경계 문제를 줄였다고 구글은 설명합니다. 웹 배너, 긴 타임라인, 가로형 설명도처럼 보통 비율보다 넓은 결과가 필요한 작업에 직접 관련된 개선입니다.
다만 높은 해상도가 곧바로 정확한 결과를 보장하지는 않습니다. 글자가 많은 도표라면 먼저 본문 문구를 확정하고, 이미지 안에는 짧은 제목과 핵심 레이블만 넣는 편이 안전합니다. 공식 가이드도 이미지 속 텍스트가 필요할 때는 텍스트를 먼저 만든 뒤 그 문구를 이미지에 넣도록 요청하는 방식을 권합니다.
2. 한 번 만들고 끝내는 생성보다 반복 편집에 초점이 있습니다
Nano Banana 2.1은 대화형 편집 모델입니다. 첫 결과를 다시 처음부터 설명하는 대신 “왼쪽 인물은 유지하고 배경만 야간으로 변경”, “제품의 모양은 보존하고 세로 포스터로 재구성”처럼 이전 결과와 참조 이미지를 이어서 수정하는 흐름에 적합합니다. 공식 모델 카드도 일반 편집, 스타일 변경, 인물·사물 편집, 낙서나 마스크를 이용한 편집, 여러 이미지 결합, 다중 턴 작업을 주요 사용 범위로 제시합니다.
3. 여러 인물과 제품을 한 장면에 배치할 때 기준이 생겼습니다
최대 14장의 참조 이미지를 섞을 수 있지만, 숫자를 그대로 “14개 모두 완벽히 복제”라는 뜻으로 이해하면 안 됩니다. 공식 가이드는 인물 닮음 유지 기준을 최대 4명, 사물 충실도 기준을 최대 10개로 구분합니다. 참조 이미지는 정면·측면·색상처럼 역할을 나누고, 프롬프트에서 어떤 특징을 반드시 보존할지 지정해야 합니다.
4. 웹·이미지 검색 그라운딩을 사용할 수 있습니다
검색 그라운딩은 최신 날씨, 장소, 제품 정보처럼 외부 사실을 참고해야 하는 이미지 작업에 유용할 수 있습니다. 하지만 검색 결과가 최종 이미지의 사실 정확성을 자동으로 보장하는 것은 아닙니다. 공식 제한 사항에 따르면 검색 그라운딩은 현재 웹에서 찾은 실제 인물 이미지를 이미지 생성에 사용하는 방식은 지원하지 않습니다. 사람, 로고, 지도, 통계처럼 오류 비용이 큰 요소는 원문과 최종 이미지를 따로 대조해야 합니다.
시작 전 준비사항
- Google AI Studio 또는 Gemini API를 사용할 Google 계정
- Gemini API 키가 연결된 Google Cloud 프로젝트. 신규 키는 AI Studio의 Dashboard → API Keys에서 만들 수 있습니다.
- 유료 티어와 예산 확인. Nano Banana 2.1은 공식 가격표상 API 무료 티어가 없습니다.
- Python 3.9 이상 또는 Node.js 18 이상. 아래 예시는 Python과 Google Gen AI SDK를 사용합니다.
- 참조 이미지 권리 확인. 본인 소유 자료이거나 편집·재사용 권한이 있는 파일만 사용합니다.
- 비밀키 저장 위치. API 키를 코드나 공개 저장소에 직접 넣지 말고 환경 변수나 비밀 저장소를 사용합니다.
Google AI Studio에서 먼저 확인하는 순서
- 공식 모델 페이지의 Try in Google AI Studio를 열거나 AI Studio에서 새 프롬프트를 만듭니다.
- 모델 선택에서 Gemini Nano Banana 2.1 또는 모델 ID
gemini-nano-banana-2.1을 확인합니다. - 처음에는 참조 이미지 없이 짧은 텍스트로 1K 결과를 요청합니다. 구성과 프롬프트 반응을 먼저 확인하는 단계입니다.
- 같은 대화에서 한 번에 하나씩 수정합니다. 예를 들어 배경, 화면 비율, 문구, 색상 순으로 분리합니다.
- 최종 용도에 따라 2K 또는 4K로 올리고, 이미지 안의 글자·인물 손·로고 모양·반복 무늬·가장자리 타일링을 확대해 검토합니다.
완료 확인: 모델명이 정확하고, 요청한 비율과 해상도가 반영됐으며, 참조 자료의 핵심 특징과 이미지 속 문구를 사람이 직접 확인했을 때에만 다음 작업으로 넘깁니다.
Python API로 이미지 한 장 생성하기
먼저 SDK를 설치하고 API 키를 환경 변수에 저장합니다.
pip install -U google-genai
export GEMINI_API_KEY="YOUR_API_KEY"
다음은 Interactions API로 이미지만 반환하도록 요청하는 최소 예시입니다.
from google import genai
import base64
client = genai.Client()
interaction = client.interactions.create(
model="gemini-nano-banana-2.1",
input=(
"Create a clean horizontal editorial illustration of a research desk. "
"Use a 16:9 composition, restrained colors, and no logos."
),
response_format={
"type": "image",
"aspect_ratio": "16:9",
"image_size": "2K",
},
)
with open("output.png", "wb") as file:
file.write(base64.b64decode(interaction.output_image.data))
실행 위치: 터미널에서 가상환경을 활성화한 프로젝트 폴더에 파일을 저장하고 실행합니다. 완료 확인: 오류 없이 output.png가 만들어지고 이미지 뷰어에서 열리는지 확인합니다. 이 코드는 공식 문서의 호출 구조를 단순화한 예시이며, 여기서는 실제 결과 품질이나 실행 성공을 주장하지 않습니다.
기존 Nano Banana 2 코드 옮기기
가장 먼저 바꿀 부분은 모델 ID입니다.
# 이전
model="gemini-3.1-flash-image"
# 변경
model="gemini-nano-banana-2.1"
모델 이름만 바꾸고 바로 전체 운영 트래픽을 넘기기보다 다음 순서로 검증하는 편이 안전합니다.
- 대표 프롬프트 10~20개와 참조 이미지를 별도 테스트 세트로 고정합니다.
- 1K·2K·4K별 출력 비용과 처리 시간을 기록합니다.
- 문구 정확성, 인물·제품 일관성, 금지 요소, 파노라마 경계를 사람이 비교합니다.
- 기존 후처리 코드가 이미지 크기와 파일 형식을 정상 처리하는지 확인합니다.
- 통과한 뒤 일부 요청부터 새 모델로 옮기고 오류율과 비용을 관찰합니다.
종료일이 발표되지 않았다고 해서 이전을 무기한 미루는 것은 안전하지 않습니다. 반대로 사용 중단 예정이라는 이유만으로 품질 검증 없이 한 번에 바꾸는 것도 위험합니다.
비용을 계산할 때 놓치기 쉬운 부분
2026년 10월 8일 확인한 공식 가격표의 표준 처리 기준은 입력 100만 토큰당 1.50달러, 텍스트·사고 출력 100만 토큰당 7.50달러, 이미지 출력 100만 토큰당 30달러입니다. 구글이 제시한 이미지당 환산값은 1K 약 0.0336달러, 2K 약 0.0504달러, 4K 약 0.113달러입니다. Batch API는 각각 절반 수준의 단가를 제시합니다.
이 값은 이미지 출력 부분의 환산값입니다. 긴 프롬프트, 여러 참조 이미지, 텍스트 출력, 검색 그라운딩, 재시도 횟수까지 합치면 실제 요청 비용은 달라집니다. 검색 그라운딩은 Gemini 3.x 모델 전체가 공유하는 월 5,000회의 무료 검색 요청 이후 1,000회당 14달러로 안내됩니다. 운영 전에는 AI Studio의 Usage에서 실제 사용량을 확인하고 요청당 최대 해상도와 재시도 횟수를 정해야 합니다.
실용적인 활용 예시 3가지
예시 1. 블로그 설명 이미지와 인포그래픽
목적: 긴 글의 구조를 한눈에 보여주는 가로형 설명 이미지를 만듭니다. 준비: 확정된 소제목 3~5개, 사용할 색상, 금지할 로고·인물, 최종 비율을 정합니다. 진행: 먼저 텍스트만 확정하고, 1K에서 구도를 잡은 뒤 2K로 올립니다. 검토: 이미지 안 문구와 본문의 수치가 일치하는지, 모바일에서 글자가 읽히는지 확인합니다. 텍스트가 길다면 HTML 표나 본문으로 남기고 이미지는 관계와 흐름만 맡깁니다.
예시 2. 제품과 캐릭터가 반복되는 캠페인 시안
목적: 같은 인물·제품을 정사각형 게시물, 가로 배너, 세로 포스터에 반복 배치합니다. 준비: 권리가 확인된 정면·측면 참조와 반드시 유지할 특징을 적습니다. 진행: 여러 장을 한 번에 던지기보다 인물, 제품, 배경 순으로 고정하고 각 턴에서 한 요소만 바꿉니다. 검토: 얼굴, 손, 로고, 제품 버튼 수, 색상과 비율을 원본과 비교합니다. 공식 수치보다 많은 인물이나 사물을 한 장면에 억지로 넣지 않습니다.
예시 3. 파노라마 웹 배너와 타임라인
목적: 1:4 또는 1:8처럼 긴 가로 결과를 만듭니다. 준비: 중앙 안전 영역, 좌우 여백, 잘려도 되는 배경 요소를 정합니다. 진행: 1K 초안으로 배치를 잡고 최종본은 2K나 4K로 생성합니다. 검토: 반복 패턴, 이어 붙인 듯한 경계, 가장자리 왜곡을 100% 확대에서 확인합니다. 긴 배너의 제목은 이미지에 굽기보다 웹의 실제 텍스트로 올리면 접근성과 수정성이 좋아집니다.
자주 막히는 문제와 해결 순서
- 모델을 찾을 수 없음: 모델 ID 철자를 확인하고 SDK를 업데이트한 뒤, 프로젝트의 결제 상태와 사용 가능 지역을 확인합니다.
- API 키 오류:
GEMINI_API_KEY환경 변수가 현재 터미널에 설정됐는지, 키가 해당 프로젝트와 연결됐는지, 필요한 제한이 적용됐는지 확인합니다. - 작은 글자가 흐림: 긴 문장을 줄이고 핵심 문구만 사용합니다. 텍스트를 먼저 확정한 뒤 2K·4K로 생성하고, 최종 문구는 반드시 수동 교정합니다.
- 참조 인물이 달라짐: 인물 수를 줄이고 각 참조의 역할을 명시합니다. 한 턴에서 배경·의상·포즈를 모두 바꾸지 말고 한 요소씩 수정합니다.
- 요청한 이미지 개수가 맞지 않음: 공식 문서도 정확한 출력 개수를 항상 따르지는 않을 수 있다고 명시합니다. 결과 개수를 코드에서 검사하고 부족하면 제한된 횟수만 재요청합니다.
- 시간 초과 또는 느린 응답: 참조 수와 해상도를 낮춰 원인을 분리하고, 대량 작업은 Batch API를 검토합니다. 재시도에는 상한과 지수 백오프를 둡니다.
보안·저작권·정확성 체크리스트
- API 키를 코드, 브라우저 자바스크립트, 공개 저장소에 넣지 않습니다.
- 운영 키에는 IP·애플리케이션·API 제한을 적용하고 개발 키와 분리합니다.
- 업로드하는 인물·제품·문서에 편집과 재사용 권한이 있는지 확인합니다.
- 검색 그라운딩을 사용해도 최종 이미지의 수치·지도·문구는 원문과 대조합니다.
- 모든 생성 이미지에는 보이지 않는 SynthID 워터마크가 포함된다는 공식 안내를 고려합니다.
- 실제 사진, 제품 화면, 실험 결과로 오인될 수 있는 이미지는 맥락과 캡션으로 구분합니다.
어떤 경우에 Nano Banana 2.1을 선택할까
빠른 이미지 생성과 반복 편집, 여러 참조의 일관성, 4K·파노라마 출력, 검색 근거가 한 작업에 함께 필요하다면 Nano Banana 2.1이 우선 후보입니다. 가장 낮은 비용과 속도가 최우선이면 Nano Banana 2 Lite, 복잡한 브랜드 일관성과 정밀 제어가 더 중요하면 Nano Banana Pro를 함께 비교할 수 있습니다. 로컬 실행, 투명 PNG, 공개 가중치와 라이선스가 핵심이라면 성격이 다른 오픈 모델도 검토해야 합니다. 관련 비교 관점은 Qwen-Image-2.1 투명 PNG·다중 이미지 편집 가이드에서 이어서 볼 수 있습니다.
English version: Gemini Nano Banana 2.1 Guide: Image Generation, Editing, and API Migration
공식 자료
- Gemini API Release notes
- Gemini Nano Banana 2.1 model page
- Nano Banana image generation guide
- Gemini API pricing
- Google DeepMind Nano Banana 2.1 model card
자료 확인일: 2026년 10월 8일. 가격·지원 지역·모델 상태는 변경될 수 있으므로 운영 적용 전 공식 문서를 다시 확인하세요.
댓글
댓글 쓰기