메인 콘텐츠로 건너뛰기

개요

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.045/요청, 1K / 2K / 4K 모두 동일한 가격이며 2026년 10월 13일부터 $0.05에서 인하됨)과 token 기반 과금(입력 1M tokens당 $0.66 / 출력 1M tokens당 $13.2)을 모두 지원합니다. Nano Banana 2도 동일한 가격으로 계속 제공되며, Google은 해당 모델의 서비스 종료일을 발표하지 않았습니다.
모든 이미지 API는 동기식입니다. 폴링할 작업 ID가 없으며, 요청에 대한 과금이 계속 진행되는 동안 클라이언트 연결이 끊기면 결과가 손실됩니다. 이 모델에는 넉넉한 타임아웃을 설정하십시오. 이미지 API 필수 사항 및 모범 사례를 참조하십시오.

텍스트-이미지 API

텍스트 prompt에서 이미지를 생성하며, 대화형 Playground를 제공합니다.

이미지 편집 API

이미지와 지시사항을 업로드하여 편집된 결과를 얻으며, 대화형 Playground를 제공합니다.

AI 에이전트가 대신 통합하도록 하십시오

이 프롬프트를 복사하여 Codex / Claude Code / Cursor에 붙여넣으십시오

먼저 이 페이지의 일반 텍스트 버전을 가져오고(아무 docs URL 뒤에 .md을 추가) 사용 중인 스택에 맞는 코드를 작성합니다. 가장 흔한 문제인 타임아웃, 방어적인 parts 파싱, 업로드 압축 및 해상도 매개변수는 이미 요구사항으로 명시되어 있습니다.

이 프로젝트에 Nano Banana 2.1(gemini-nano-banana-2.1) 텍스트-이미지 생성 및 이미지 편집을 통합하십시오(또는 디버깅하십시오).

코드를 작성하기 전에 문서를 읽으십시오. 일반 텍스트 버전의 이 페이지를 가져오려면 https://docs.apiyi.com/en/api-capabilities/gemini-nano-banana-2.1/overview.md 를 가져오십시오. 세부 매개변수는 .md를 추가하십시오 …

  1. 타임아웃: Gemini 네이티브 형식 POST https://api.apiyi.com/v1beta/models/gemini-nano-banana-2.1:generateContent을 사용하고 클라이언트 타임아웃을 …으로 설정하십시오.

총 7개의 요구사항입니다. 아래 버튼을 사용하여 전체 프롬프트를 복사하십시오.

주요 기능

더 뛰어난 이미지 품질

Nano Banana 2보다 시각적 품질이 향상되었으며, 이전 버전의 타일링 아티팩트가 수정되었습니다

더 정확한 텍스트

이미지 내 텍스트가 더 선명하고 오탈자가 줄어들어 포스터, 마케팅 에셋 및 인포그래픽에 적합합니다

더 안정적인 멀티턴 편집

대화형 편집을 반복해도 캐릭터와 장면의 일관성이 더 잘 유지됩니다

세 가지 추론 수준

minimal / medium / high, 기본값은 medium이며 이전 버전보다 한 단계 더 많습니다

최대 4K 출력

1K / 2K / 4K를 지원하며, 요청별 과금으로 4K도 1K와 비용이 같습니다

14가지 화면 비율

1:4, 4:1, 1:8 및 8:1의 초세로 및 초가로 비율을 포함하며, Google은 고해상도에서 와이드 형식이 더 보기 좋다고 설명합니다

다중 참조 융합

객체 참조는 최대 10개, 캐릭터 참조는 4개, 스타일 참조는 3개까지 지원합니다

Google 검색 기반 연결

날씨 카드나 시장 차트처럼 실시간 정보가 필요한 이미지에 googleSearch 도구를 연결합니다

Nano Banana 2와의 차이점

사용할 모델:
  • 새 프로젝트 → Nano Banana 2.1: 품질이 더 우수하고 요청당 비용도 저렴합니다
  • 이미 Nano Banana 2를 사용 중인 경우 → 모델 이름을 변경하여 전환합니다. 코드에서 512 등급을 사용하는 경우 먼저 1K로 변경합니다
  • 512px 썸네일이 필요한 경우 → Nano Banana 2를 계속 사용하거나 Nano Banana 2 Lite를 사용합니다
  • 최고 품질을 원하는 경우 → Nano Banana Pro ($0.09/요청)

가격

과금 모드 선택: Nano Banana 2.1은 두 가지 과금 모드를 지원하며, token을 생성할 때 “Billing model” 설정으로 선택합니다.
  • 종량제 또는 종량제 우선 → token 기반 과금
  • 요청당 결제 또는 요청당 결제 우선 → 요청당 과금
  • ⚠️ Hybrid 과금은 선택하지 마십시오

요청당 과금

2026년 10월 13일부터 가격 10% 인하: 요청당 $0.05 → $0.045 (1K / 2K / 4K 동일).
  • 이유: token 기반 과금에서는 1K / 2K 이미지의 비용이 이미 이미지당 $0.02–$0.04에 불과하여 요청당 $0.05가 비싸게 느껴질 수 있으므로, 요청당 가격도 인하했습니다. 4K의 경우 요청당 과금이 token 기반 과금($0.06 이상)보다 이제 거의 30% 저렴합니다.
  • token 기반 가격은 변경되지 않았습니다: 입력 1M token당 $0.66 / 출력 1M token당 $13.2.
  • 더 저렴하게 이용: 10%–20% 충전 보너스를 적용하면 실질적인 요청당 비용은 약 $0.038–$0.041입니다.

token 기반 과금

모델 가격은 공식 웹사이트와 동일한 기준으로 적용되며 웹사이트에 따라 변경될 수 있습니다. 위 표는 참고용일 뿐이며, 상단 내비게이션의 모델 가격 탭이 최신 기준입니다: 모델 가격.

token 기반 과금: 운영 환경의 실제 요금

Nano Banana 2.1은 기본적으로 생성 전에 추론합니다(기본 수준: 중간). 이미지 token 외에도 이미지마다 약 400–1300개의 추론 및 기타 출력 token이 생성되며, 이미지와 함께 1M token당 $13.2의 요율로 과금됩니다. 따라서 token 기반 과금에서 이미지당 비용은 고정되어 있지 않으며 변동됩니다. 아래 표는 2026-10-07에 token 기반으로 과금된 실제 요청을 바탕으로 작성되었으며, 금액은 콘솔에 표시된 실제 과금액입니다(출력 token을 기준으로 해상도 추정). 해당 날짜의 token 기반 과금 요청 60건의 분포:
선택할 과금 모드:
  • 1K / 2K → token 기반: 일반적으로 이미지당 $0.02–$0.04로, 요청당 가격 $0.045보다 저렴합니다.
  • 4K → 요청당: 고정 요금이 $0.045인 반면, token 기반 비용은 $0.06 이상입니다.
  • 한 요청에 참조 이미지가 많은 경우(예: 10개 이상): 입력 token으로 인해 token 기반 비용이 $0.045에 가까워지거나 이를 초과하므로, 이러한 경우에도 요청당 과금을 사용하십시오.
충전 보너스를 함께 적용하면 실제 비용은 더욱 낮아집니다.
이미지 token만으로 비용을 계산하면 과소평가되는 이유: thoughtsTokenCount은 usageMetadata에 포함되지 않지만, candidatesTokenCount에서는 출력 token으로 집계되어 APIYI 로그에 기록되고 과금됩니다. 1120 / 1680 / 3780 token을 기준으로 추정하면 비용을 20%–40% 과소평가하게 됩니다. 콘솔 로그의 과금액과 대조하여 확인하십시오.

요금에 영향을 미치는 매개변수

thinkingLevel: 기본값은 medium이며 high는 비용이 조금만 더 듭니다

Nano Banana 2(기본값이 minimal이며 high의 비용이 54% 더 높은 경우)와 달리, 2.1은 기본적으로 이미 추론을 수행하며 high은 조금 더 오래 추론할 뿐입니다. 이미지 내 텍스트 배치나 차트 비율을 정확하게 맞춰야 하는 경우에는 자유롭게 활성화하십시오.

Google 검색 그라운딩: 검색 쿼리별로 과금됩니다

실시간 정보가 필요한 이미지(날씨 카드, 시장 차트, 최근 이벤트 포스터)의 경우 googleSearch 도구를 연결하십시오.
테스트에서는 3번 중 3번 그라운딩이 실행되었으며, 모델은 자체적으로 요청당 2개의 검색 쿼리를 실행했습니다. 쿼리당 비용은 $0.014(1,000개당 $14)입니다. 모델이 실행할 쿼리 수를 결정하며 사전에 제한할 수 없으므로, 요청당 2~3개의 쿼리를 기준으로 예산을 책정하십시오.
검색 요금은 요청당 과금에 추가로 부과됩니다: 요청당 $0.045는 이미지만 포함하며, 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를 반환하면 요청이 자동으로 대체 그룹으로 전환되어 생성을 계속합니다.

해상도 및 화면 비율

출력 해상도

512은 지원되지 않습니다: "imageSize": "512"은 400 Image size 512 is not supported for this model을 반환합니다(과금되지 않음). Nano Banana 2에서 마이그레이션할 때 변경하십시오.

지원되는 화면 비율(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을 생략하면 모델이 콘텐츠를 기반으로 비율을 선택합니다: 테스트 결과 장면 프롬프트는 대부분 16:9로, 포스터 프롬프트는 2:3 또는 3:4로 생성되었습니다. 고정된 비율이 필요하면 명시적으로 전달하십시오.

측정된 출력 크기(픽셀)

2026-10-07에 측정했으며, “—”는 아직 측정되지 않았음을 의미합니다. 1K의 8:1은 2928×352로, Nano Banana 2의 3072×384와 다릅니다. 따라서 프런트엔드 레이아웃에 Nano Banana 2의 크기 표를 재사용하지 마십시오.

자주 묻는 질문

아닙니다. 2.1은 별도의 모델 ID인 gemini-nano-banana-2.1이며, 품질, 텍스트 렌더링 및 멀티턴 일관성이 더 우수하고 과금 구조도 다릅니다(입력 비용은 더 높고, 이미지 출력 비용은 더 낮으며, 4K 이미지당 token 수는 더 많습니다). 두 모델 모두 APIYI에서 사용할 수 있으며 서로 영향을 주지 않습니다.
  1. 모델 이름을 gemini-3.1-flash-image(또는 -preview)에서 gemini-nano-banana-2.1으로 변경합니다.
  2. "imageSize": "512"를 사용하는 경우 1K로 변경합니다.
  3. token으로 비용을 추정하는 경우 위의 “이미지 한 장의 실제 비용” 표를 기준으로 다시 확인합니다.
요청 형식, 응답 구조, 다중 이미지 및 멀티턴 편집은 모두 동일하게 유지됩니다.
2026년 10월 7일 기준으로 Google은 gemini-3.1-flash-image의 종료 날짜를 발표하지 않았으며, 2.1을 권장 대체 모델로만 안내하고 있습니다. APIYI의 Nano Banana 2는 동일한 가격으로 계속 사용할 수 있습니다. 변경 사항이 생기면 사전에 알려드리겠습니다.
2.1은 기본적으로 추론을 수행하기 때문입니다. 각 이미지에는 약 400–1300개의 추론 및 기타 출력 token이 추가되며, 이미지와 함께 출력 요율로 과금됩니다. thoughtsTokenCount에서 이를 확인할 수 있습니다. 대부분 4K 이미지를 생성한다면 요청별 과금($0.045)이 더 유리합니다.
동시 실행 수 제한은 없습니다 — 동시 요청을 자유롭게 전송할 수 있으며, 요청이 서로 대기하거나 차단되지 않습니다. 중요한 것은 timeout입니다. 4K 요청이나 피크 시간대의 요청은 처리에 시간이 걸릴 수 있으므로(테스트에서 대부분의 4K 요청은 30–50초가 걸렸고, 일부는 2분을 넘었습니다) 클라이언트 타임아웃을 360초로 설정하십시오. 간헐적으로 429가 발생하면 NB-Enterprise를 token의 대체 그룹으로 추가하십시오.
모든 출력 이미지에는 보이지 않는 SynthID 워터마크가 포함됩니다(Google이 AI 생성 콘텐츠를 표시하기 위해 사용하는 마커입니다). 눈에 보이지 않으며 사용에 영향을 주지 않습니다.

관련 문서