개요
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을 사용할 것을 권장합니다.
텍스트-이미지 API
이미지 편집 API
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를 추가하십시오 …
- 타임아웃: Gemini 네이티브 형식
POST https://api.apiyi.com/v1beta/models/gemini-nano-banana-2.1:generateContent을 사용하고 클라이언트 타임아웃을 …으로 설정하십시오.
총 7개의 요구사항입니다. 아래 버튼을 사용하여 전체 프롬프트를 복사하십시오.
이 프롬프트가 방지하는 문제
이 프롬프트가 방지하는 문제
주요 기능
더 뛰어난 이미지 품질
더 정확한 텍스트
더 안정적인 멀티턴 편집
세 가지 추론 수준
최대 4K 출력
14가지 화면 비율
다중 참조 융합
Google 검색 기반 연결
googleSearch 도구를 연결합니다Nano Banana 2와의 차이점
가격
- 종량제 또는 종량제 우선 → token 기반 과금
- 요청당 결제 또는 요청당 결제 우선 → 요청당 과금
- ⚠️ Hybrid 과금은 선택하지 마십시오
요청당 과금
token 기반 과금
token 기반 과금: 운영 환경의 실제 요금
Nano Banana 2.1은 기본적으로 생성 전에 추론합니다(기본 수준: 중간). 이미지 token 외에도 이미지마다 약 400–1300개의 추론 및 기타 출력 token이 생성되며, 이미지와 함께 1M token당 $13.2의 요율로 과금됩니다. 따라서 token 기반 과금에서 이미지당 비용은 고정되어 있지 않으며 변동됩니다. 아래 표는 2026-10-07에 token 기반으로 과금된 실제 요청을 바탕으로 작성되었으며, 금액은 콘솔에 표시된 실제 과금액입니다(출력 token을 기준으로 해상도 추정).thoughtsTokenCount은 usageMetadata에 포함되지 않지만, candidatesTokenCount에서는 출력 token으로 집계되어 APIYI 로그에 기록되고 과금됩니다. 1120 / 1680 / 3780 token을 기준으로 추정하면 비용을 20%–40% 과소평가하게 됩니다. 콘솔 로그의 과금액과 대조하여 확인하십시오.요금에 영향을 미치는 매개변수
thinkingLevel: 기본값은 medium이며 high는 비용이 조금만 더 듭니다
high의 비용이 54% 더 높은 경우)와 달리, 2.1은 기본적으로 이미 추론을 수행하며 high은 조금 더 오래 추론할 뿐입니다. 이미지 내 텍스트 배치나 차트 비율을 정확하게 맞춰야 하는 경우에는 자유롭게 활성화하십시오.
Google 검색 그라운딩: 검색 쿼리별로 과금됩니다
실시간 정보가 필요한 이미지(날씨 카드, 시장 차트, 최근 이벤트 포스터)의 경우googleSearch 도구를 연결하십시오.
그룹
Nano Banana 2.1은 APIYI에서 두 개의 그룹으로 제공되며, 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을 생략하면 모델이 콘텐츠를 기반으로 비율을 선택합니다: 테스트 결과 장면 프롬프트는 대부분 16:9로, 포스터 프롬프트는 2:3 또는 3:4로 생성되었습니다. 고정된 비율이 필요하면 명시적으로 전달하십시오.
측정된 출력 크기(픽셀)
자주 묻는 질문
Nano Banana 2.1과 Nano Banana 2는 동일한 모델입니까?
Nano Banana 2.1과 Nano Banana 2는 동일한 모델입니까?
gemini-nano-banana-2.1이며, 품질, 텍스트 렌더링 및 멀티턴 일관성이 더 우수하고 과금 구조도 다릅니다(입력 비용은 더 높고, 이미지 출력 비용은 더 낮으며, 4K 이미지당 token 수는 더 많습니다). 두 모델 모두 APIYI에서 사용할 수 있으며 서로 영향을 주지 않습니다.Nano Banana 2에서 전환하려면 무엇을 변경해야 합니까?
Nano Banana 2에서 전환하려면 무엇을 변경해야 합니까?
- 모델 이름을
gemini-3.1-flash-image(또는-preview)에서gemini-nano-banana-2.1으로 변경합니다. "imageSize": "512"를 사용하는 경우1K로 변경합니다.- token으로 비용을 추정하는 경우 위의 “이미지 한 장의 실제 비용” 표를 기준으로 다시 확인합니다.
Nano Banana 2는 종료됩니까?
Nano Banana 2는 종료됩니까?
gemini-3.1-flash-image의 종료 날짜를 발표하지 않았으며, 2.1을 권장 대체 모델로만 안내하고 있습니다. APIYI의 Nano Banana 2는 동일한 가격으로 계속 사용할 수 있습니다. 변경 사항이 생기면 사전에 알려드리겠습니다.이미지 token으로 예상한 것보다 청구 금액이 높은 이유는 무엇입니까?
이미지 token으로 예상한 것보다 청구 금액이 높은 이유는 무엇입니까?
thoughtsTokenCount에서 이를 확인할 수 있습니다. 대부분 4K 이미지를 생성한다면 요청별 과금($0.045)이 더 유리합니다.동시 실행 수 제한이 있습니까?
동시 실행 수 제한이 있습니까?
timeout입니다. 4K 요청이나 피크 시간대의 요청은 처리에 시간이 걸릴 수 있으므로(테스트에서 대부분의 4K 요청은 30–50초가 걸렸고, 일부는 2분을 넘었습니다) 클라이언트 타임아웃을 360초로 설정하십시오. 간헐적으로 429가 발생하면 NB-Enterprise를 token의 대체 그룹으로 추가하십시오.출력 이미지에 워터마크가 있습니까?
출력 이미지에 워터마크가 있습니까?
관련 문서
- Nano Banana 2 이미지 생성/편집 - 이전 버전, 512px 지원
- Nano Banana Pro 이미지 생성/편집 - 최고 품질
- Nano Banana 개발 가이드 - 크기 제어, 입력 이미지 요구 사항, 이미지 URL
- Nano Banana 가격
- Gemini 이미지 오류 처리