개요
Nano Banana 2.1은 Google이 2026년 10월 6일에 출시한 이미지 생성 모델입니다. 모델 ID는 **gemini-nano-banana-2.1**이며, 정식 버전(GA)으로 출시되었습니다. 이 모델은 Nano Banana 2 (gemini-3.1-flash-image)의 업그레이드 버전으로, Flash급 속도를 유지하면서 이미지 품질, 이미지 내 텍스트 렌더링, 멀티턴 편집 일관성을 개선하였으며, 이전 버전의 타일링 아티팩트를 해결했습니다. Google은 모든 신규 프로젝트에 2.1 버전 사용을 권장합니다.
🆕 2026년 10월 6일 출시: 현재 APIYI에서 이용 가능하며, 요청당 과금(요청당 $0.05, 1K / 2K / 4K 동일 가격) 및 token 기반 과금(1M tokens당 입력 $0.66 / 출력 $13.2)을 모두 지원합니다. Nano Banana 2 역시 동일한 가격으로 계속 이용할 수 있으며, Google은 해당 모델의 서비스 종료 일정을 발표하지 않았습니다.
모든 이미지 API는 동기식입니다. 폴링할 작업 ID가 없으며, 클라이언트 연결이 끊어지면 결과가 유실되더라도 요청에 대한 요금은 과금됩니다. 이 모델에는 타임아웃을 넉넉하게 설정하십시오. 자세한 내용은 이미지 API 필수 사항 및 모범 사례를 참고하십시오.
텍스트-이미지 변환 API
텍스트 prompt로부터 이미지를 생성하며, 대화형 Playground를 제공합니다.
이미지 편집 API
이미지와 지시 사항을 업로드하여 편집된 결과를 얻을 수 있으며, 대화형 Playground를 제공합니다.
AI 에이전트를 통한 연동
Codex, Claude Code 또는 Cursor를 사용하여 개발하는 경우 아래 prompt를 복사하여 입력하십시오. 먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 문서 URL 끝에
.md 추가) 사용자의 기술 스택에 맞는 코드를 작성합니다. 타임아웃, 방어적 parts 파싱, 업로드 압축, 해상도 파라미터 등 가장 흔히 발생하는 함정들이 이미 요구사항으로 명시되어 있습니다.코딩 에이전트가 Nano Banana 2.1 텍스트-이미지 생성 및 이미지 편집을 연동하거나 디버깅하도록 설정합니다. Codex, Claude Code, Cursor 등에 복사하여 붙여넣으십시오.
이 prompt를 통해 방지할 수 있는 문제
이 prompt를 통해 방지할 수 있는 문제
주요 기능
향상된 화질
Nano Banana 2보다 시각적 품질이 더 뛰어나며, 이전 버전의 타일링 현상이 해결되었습니다.
더 정확한 텍스트 표현
이미지 내 텍스트가 더 선명하고 오탈자가 적어 포스터, 마케팅 자료 및 인포그래픽 제작에 적합합니다.
더 안정적인 멀티턴 편집
대화형 편집 과정에서 캐릭터와 장면이 더욱 일관되게 유지됩니다.
3가지 사고 수준
minimal / medium / high(기본값: medium)를 지원하며, 이전 버전보다 단계가 하나 더 추가되었습니다.
최대 4K 해상도 출력
1K / 2K / 4K를 지원하며, 요청당 과금 방식을 적용하여 4K도 1K와 동일한 비용으로 이용할 수 있습니다.
14가지 화면비
매우 세로로 긴 1:4, 1:8 및 매우 가로로 긴 4:1, 8:1 비율을 포함합니다. Google에 따르면 와이드 포맷은 고해상도에서 더욱 뛰어난 품질을 보여줍니다.
멀티 레퍼런스 융합
최대 10개의 객체 참조 + 4개의 캐릭터 참조 + 3개의 스타일 참조를 지원합니다.
Google 검색 그라운딩
날씨 카드나 시장 차트처럼 실시간 정보가 필요한 이미지를 위해
googleSearch 도구를 연결하여 사용할 수 있습니다.Nano Banana 2와의 차이점
요금 안내
과금 모드 선택: Nano Banana 2.1은 두 가지 과금 모드를 지원하며, token 생성 시 “Billing model” 설정을 통해 선택할 수 있습니다:
- Pay-as-you-go 또는 Pay-as-you-go Priority → token 기반 과금
- Pay-per-request 또는 Pay-per-request Priority → 요청당 과금
- ⚠️ Hybrid billing을 선택하지 마십시오
요청당 과금
token 기반 과금
모델 가격은 공식 웹사이트를 기준으로 하며 변동될 수 있습니다. 위 표는 참고용일 뿐이며, 상단 탐색 메뉴의 모델 요금 탭이 기준이 됩니다: 모델 요금.
token 기반 과금: 실제 운영 청구 내역
Nano Banana 2.1은 기본적으로 생성 전에 추론을 수행합니다(기본 레벨: medium). 이미지 token 외에도 각 이미지마다 약 400~1,300개의 추론 및 기타 출력 token이 생성되며, 이미지와 함께 1M tokens당 $13.2로 과금됩니다. 따라서 token 기반 과금 방식에서 이미지당 비용은 고정되어 있지 않고 변동됩니다. 아래 표는 2026-10-07 실제 token 과금 요청에서 추출한 데이터이며, 금액은 콘솔의 실제 청구 금액입니다(해상도는 출력 token을 기반으로 추정됨):
당일 token 과금 요청 60건의 분포:
이미지 token만으로 비용을 추정하면 과소평가되는 이유:
thoughtsTokenCount(usageMetadata 항목)은 candidatesTokenCount에 포함되지 않지만, APIYI 로그에는 출력 tokens로 집계되어 과금됩니다. 1120 / 1680 / 3780 tokens를 기준으로 추정하면 비용이 20%–40% 과소평가됩니다. 콘솔 로그의 청구 내역을 통해 대조 확인하시기 바랍니다.요금에 영향을 미치는 매개변수
thinkingLevel: 기본값은 medium이며, high로 설정해도 비용 증가는 미미합니다
Nano Banana 2(기본값 minimal,
high 설정 시 비용 54% 증가)와 달리, 2.1은 기본적으로 이미 생각을 수행하며, high는 단지 조금 더 오래 생각할 뿐입니다. 이미지 내 텍스트 레이아웃이나 차트 비율을 정확히 맞춰야 할 때 부담 없이 활성화하십시오.
Google Search 그라운딩: 검색 쿼리당 과금
실시간 정보가 필요한 이미지(날씨 카드, 시장 차트, 최근 이벤트 포스터 등)의 경우googleSearch 도구를 연결하십시오:
그룹
Nano Banana 2.1은 APIYI에서 두 가지 그룹으로 제공되며, token 설정에서 전환할 수 있습니다:
권장 token 과금 모드:
Pay-as-you-go Priority을 선택하십시오 — Nano Banana 2 / 2.1의 token 기반 과금 및 Nano Banana Pro의 요청당 과금을 모두 지원하므로 하나의 token으로 전체 제품군을 커버할 수 있습니다. Default을 기본 그룹으로, NB-Enterprise을 대체 그룹으로 지정하십시오. 기본 그룹에서 429가 반환되면 요청이 자동으로 대체 그룹으로 전환되어 생성을 계속 진행합니다.
해상도 및 화면비
출력 해상도
지원되는 화면비 (14개)
1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
aspectRatio을(를) 생략하면 모델이 콘텐츠를 기반으로 비율을 선택합니다: 테스트 결과, 장면 prompt는 대부분 16:9로, 포스터 prompt는 2:3 또는 3:4로 생성되었습니다. 고정된 비율이 필요한 경우 명시적으로 전달하십시오.
측정된 출력 크기 (픽셀)
2026-10-07에 측정되었으며, “—”는 아직 측정되지 않았음을 의미합니다. 1K 기준 8:1 비율은 2928×352로 Nano Banana 2의 3072×384와 다르므로, 프론트엔드 레이아웃에 Nano Banana 2의 크기 표를 재사용하지 마십시오.
자주 묻는 질문
Nano Banana 2.1과 Nano Banana 2는 동일한 모델인가요?
Nano Banana 2.1과 Nano Banana 2는 동일한 모델인가요?
아닙니다. 2.1은 별도의 모델 ID인
gemini-nano-banana-2.1을 사용하며, 더 우수한 품질, 텍스트 렌더링, 멀티턴 일관성을 제공하고 가격 책정 구조도 다릅니다(입력 비용 증가, 이미지 출력 비용 절감, 4K 이미지당 더 많은 tokens 소모). 두 모델 모두 APIYI에서 이용하실 수 있으며 서로 영향을 주지 않습니다.Nano Banana 2에서 전환하려면 무엇을 변경해야 하나요?
Nano Banana 2에서 전환하려면 무엇을 변경해야 하나요?
- 모델명을
gemini-3.1-flash-image(또는-preview)에서gemini-nano-banana-2.1(으)로 변경하십시오. "imageSize": "512"을(를) 사용하는 경우1K(으)로 변경하십시오.- tokens 기준으로 비용을 예상하는 경우, 위의 “이미지 1장당 실제 비용” 표를 참고하여 다시 확인하십시오.
Nano Banana 2는 서비스가 종료되나요?
Nano Banana 2는 서비스가 종료되나요?
2026년 10월 7일 기준, Google은
gemini-3.1-flash-image의 서비스 종료일을 발표하지 않았으며 2.1을 권장 대체 모델로만 안내하고 있습니다. APIYI의 Nano Banana 2는 동일한 가격으로 계속 이용하실 수 있습니다. 변경 사항이 있을 경우 사전에 안내해 드리겠습니다.이미지 tokens에서 예상한 것보다 청구 금액이 더 높은 이유는 무엇인가요?
이미지 tokens에서 예상한 것보다 청구 금액이 더 높은 이유는 무엇인가요?
2.1은 기본적으로 추론을 수행하므로 각 이미지마다 약 400~1300개의 추론 및 기타 출력 tokens이 추가되며, 이미지와 함께 출력 요율로 과금됩니다. 이는
thoughtsTokenCount에서 확인하실 수 있습니다. 주로 4K 이미지를 생성하는 경우, 요청당 과금($0.05) 방식이 더 유리합니다.동시 실행 수 제한이 있나요?
동시 실행 수 제한이 있나요?
동시 실행 수 제한은 없습니다 — 동시 요청을 자유롭게 전송하실 수 있으며, 대기열에 들어가거나 서로를 차단하지 않습니다. 중요한 것은
timeout입니다. 4K 생성 또는 피크 시간대 요청은 시간이 다소 소요될 수 있으므로(자체 테스트 결과 대부분의 4K 요청은 30~50초, 일부는 2분 이상 소요됨), 클라이언트 타임아웃을 360초로 설정하십시오. 간혹 429 오류가 발생하는 경우 token의 폴백 그룹으로 NB-Enterprise을(를) 추가하십시오.출력 이미지에 워터마크가 포함되나요?
출력 이미지에 워터마크가 포함되나요?
모든 출력 이미지에는 눈에 보이지 않는 SynthID 워터마크(AI 생성 콘텐츠에 대한 Google의 식별 마커)가 포함되어 있습니다. 육안으로 보이지 않으며 사용에 영향을 주지 않습니다.
관련 문서
- Nano Banana 2 이미지 생성/편집 - 이전 버전, 512px 지원
- Nano Banana Pro 이미지 생성/편집 - 최고 품질
- Nano Banana 개발 가이드 - 크기 제어, 입력 이미지 요구 사항, 이미지 URL
- Nano Banana 요금 안내
- Gemini 이미지 오류 처리