개요
Nano Banana 2 (코드명)는 2026년 2월 26일에 출시된 Google의 최신 이미지 생성 모델로, 모델 ID는gemini-3.1-flash-image-preview입니다. Pro급 품질에 Flash급 속도와 비용으로 이미지 생성의 비용 효율성을 재정의하며, Nano Banana 시리즈의 최신 플래그십입니다.
-preview 삭제됨): Google이 공식 문서를 업데이트하고 안정판 모델 이름 gemini-3.1-flash-image(-preview 없음)을 출시했습니다. APIYI는 이미 이를 지원합니다.- 기존 이름도 계속 작동합니다:
gemini-3.1-flash-image-preview는 이전과 같이 계속 작동하며, 과금은 변경되지 않으며, 코드 변경이 필요하지 않습니다. - 두 이름 모두 사용 가능합니다: 새
gemini-3.1-flash-image이름 또는 원래-preview이름을 모두 사용할 수 있습니다.
텍스트-이미지 API
이미지 편집 API
APIYI의 Nano Banana 2를 선택해야 하는 이유는 무엇입니까?
Nano Banana Pro / 2는 APIYI에서 사용량 기준 1위 모델입니다 — 안정적이고 신뢰할 수 있으며 빠릅니다. 전문 팀과 함께 일하고 싶으시다면 APIYI가 올바른 선택입니다. 막 출시된 Google 플래그십은 공급원 측에서 여전히 용량 제약이 있지만 — APIYI는 신뢰성, 비용, 통합 전반에서 경험을 깊이 최적화합니다:공식 채널 · Gemini와 동일
/v1beta/models/.../generateContent) 및 OpenAI SDK 패턴과 100% 호환됩니다 — 요청 본문, 응답 필드, 오류 코드가 동일합니다. 코드 수정 없는 마이그레이션이 가능합니다.동시 실행 수 제한 없음
Google 정가의 28-36%
글로벌 무장벽 접근
api.apiyi.com에 직접 연결할 수 있습니다. 안정적인 지연 시간, 국경 간 재구성 불필요.전체 모델 라인업
전문 엔터프라이즈 지원
핵심 기능
프로급 품질
4K 울트라 HD 출력
14개 화면 비율
이미지 검색 그라운딩
정확한 텍스트 렌더링
멀티턴 편집
추론 모드
피사체 일관성
버전 비교
가격
- Pay-as-you-go 또는 Pay-as-you-go Priority 선택 → token 기반 과금
- Pay-per-request 또는 Pay-per-request Priority 선택 → 호출당 과금(Nano Banana Pro와 동일)
- ⚠️ Hybrid billing은 선택하지 마십시오
호출당 과금
token 기반 과금 (Nano Banana 2 전용)
token 기반 과금 가격 추정치
그룹 설정
Nano Banana 2는 APIYI에서 두 개의 그룹과 함께 제공됩니다. 대시보드 → Token 설정에서 전환합니다:NanoBananaEnterprise로 전환하여 급증을 버티십시오.
권장 과금 모델: Pay-as-you-go Priority를 선택하십시오 — Nano Banana 2의 token 기반 과금과 Nano Banana Pro의 호출당 과금을 모두 포함하며, 시리즈 전체를 위한 하나의 Token입니다.

Token settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)
지원되는 해상도 및 종횡비
출력 해상도
지원되는 종횡비 (총 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
종횡비별 출력 크기(픽셀)
아래 표는 Google 공식 문서를 바탕으로 512px / 1K / 2K / 4K 해상도 티어 전반에서 Nano Banana 2의 실제 출력 크기를 나열합니다. 요청에서는 비율에aspect_ratio를, 티어에 image_size(또는 resolution)를 설정하십시오:
1:4, 4:1, 1:8, 8:1를 추가합니다. 이는 장문형 이미지와 인포그래픽에 이상적인 초세로형/초가로형 비율입니다. 또한 512px 저해상도 티어를 지원하는 유일한 모델로, 썸네일과 빠른 미리보기에 매우 적합합니다.자주 묻는 질문
Nano Banana 2와 Nano Banana Pro의 차이점은 무엇입니까?
Nano Banana 2와 Nano Banana Pro의 차이점은 무엇입니까?
gemini-3.1-flash-image-preview)는 Gemini 3.1 Flash를 기반으로 하고, Nano Banana Pro (gemini-3-pro-image-preview)는 Gemini 3 Pro를 기반으로 합니다. 주요 차이점은 다음과 같습니다:- ✅ 속도: Nano Banana 2가 더 빠릅니다(Flash급 속도)
- ✅ 가격: Nano Banana 2의 token 기반 과금이 더 저렴합니다($0.025부터 vs $0.09)
- ✅ 종횡비: Nano Banana 2는 14개를 지원합니다(4개 더 많음)
- ✅ 이미지 검색 그라운딩: Nano Banana 2 전용입니다
- ⚠️ 최종 품질: Nano Banana Pro가 여전히 약간 더 좋습니다
Nano Banana Pro에서 Nano Banana 2로 바꾸어야 합니까?
Nano Banana Pro에서 Nano Banana 2로 바꾸어야 합니까?
gemini-3-pro-image-preview에서 gemini-3.1-flash-image-preview로 바꾸기만 하면 됩니다.gemini-3.1-flash-image-preview와 -4k 접미사 버전 중 어느 것을 사용해야 합니까?
gemini-3.1-flash-image-preview와 -4k 접미사 버전 중 어느 것을 사용해야 합니까?
gemini-3.1-flash-image-preview(-4k 접미사 없음)을 사용하고, gemini-3.1-flash-image-preview-4k는 사용하지 않는 것을 권장합니다.- 공식 이름에는
-4k가 없습니다: Google의 공식 모델 이름은gemini-3.1-flash-image-preview입니다. 또한 이 모델은 우리가 유지보수에 가장 많은 리소스를 투입하는 일반 채널이므로, 안정성과 호환성이 가장 좋습니다. -4k의 유래:gemini-3.1-flash-image-preview-4k은 Chatbox 같은 대화형 클라이언트의 ‘chat-to-image’ 시나리오를 위해 원래 준비된 설정이었습니다. 즉, 메시징 UI에서 채팅을 통해 직접 이미지를 생성하는 방식입니다.- 코드 + Gemini 네이티브 형식은 일반 이름을 더 선호합니다: 코드로 Gemini 네이티브 형식(
/v1beta/models/.../generateContent)을 사용할 경우, 일반 모델 이름gemini-3.1-flash-image-preview이 더 안정적입니다.
-4k 모델 이름에 의존할 필요가 없습니다. 요청 매개변수에서 4K 해상도를 지정하기만 하면 됩니다(위의 ‘지원되는 해상도 및 종횡비’ 참고).Image Search Grounding이란 무엇입니까?
Image Search Grounding이란 무엇입니까?
Thinking Mode는 무엇을 합니까?
Thinking Mode는 무엇을 합니까?
high로 설정하면 가장 좋은 결과를 얻을 수 있지만 생성 시간이 약간 늘어납니다. 정밀한 구도, 텍스트 렌더링, 복잡한 장면이 필요한 작업에 가장 적합합니다.이미지 생성에는 얼마나 걸립니까?
이미지 생성에는 얼마나 걸립니까?
- 1K 해상도: 약 5~10초
- 2K 해상도: 약 10~15초
- 4K 해상도: 약 15~25초
- 높은 thinking mode를 활성화하면 몇 초가 더 추가됩니다
동시 실행 수 제한이 있습니까? API는 직렬 처리입니까? 20명의 사용자가 동시에 호출해야 하면 어떻게 합니까?
동시 실행 수 제한이 있습니까? API는 직렬 처리입니까? 20명의 사용자가 동시에 호출해야 하면 어떻게 합니까?
timeout입니다: 이미지 생성(특히 4K이거나 피크 혼잡 시)은 요청당 시간이 꽤 걸릴 수 있으므로, 아직 정상적으로 처리 중인 요청이 끊기지 않도록 클라이언트 timeout을 360초로 설정하십시오.어떤 입력 이미지 형식이 지원됩니까?
어떤 입력 이미지 형식이 지원됩니까?
image/png 및 image/jpeg 형식을 지원합니다. base64 인코딩 또는 Files API를 통해 업로드할 수 있습니다.출력 이미지에 워터마크가 있습니까?
출력 이미지에 워터마크가 있습니까?
connection reset by peer / write_response_body_failed (500) 오류가 나는 이유는 무엇입니까?
connection reset by peer / write_response_body_failed (500) 오류가 나는 이유는 무엇입니까?
- 이미지 개수를 제한하십시오: 공식 규칙(한 prompt당 최대 14장) 내에서 유지하십시오. 참조 이미지를 지나치게 많이 넣지 마십시오.
- 이미지당 크기를 제한하십시오: 각 이미지를 5MB 이하로 유지하십시오. 공식 이미지당 상한은 7MB이며, base64 인코딩은 크기를 대략 1/3 정도 늘리므로 여유를 남겨 두십시오.
- 업로드 전에 프런트엔드에서 압축하십시오: API로 보내기 전에 프런트엔드(또는 서버 측 릴레이)에서 이미지를 압축하십시오. 일반적으로 가장 긴 변을 제한하고, JPEG/WebP로 변환하며, quality 매개변수를 조정합니다.
- URL 입력으로 전환하십시오: Gemini 네이티브 형식은
fileData.fileUri를 통해 이미지 URL 전달을 지원하므로, 지나치게 큰 base64 요청 본문 문제를 완전히 피할 수 있습니다. Nano Banana 개발 가이드를 참고하십시오.
관련 문서
- Nano Banana Pro 이미지 생성 - 이전 플래그십 버전
- Nano Banana 이미지 편집 - 이미지 편집 기능
- 이미지 생성 비교 테스트
- API 사용 설명서