Nano Banana Pro 지원 범위
공개 가격은 2026년 9월 24일 기준이며 2026년 10월 10일에 확인했습니다. 최신 가격은 모델 및 가격에서 볼 수 있습니다. 이 모델은 Google 공식 채널에서 제공되고, 건당 과금 경로는 가격이 하나이며 모든 크기에서 Google 표준 가격(1K·2K $0.134, 4K $0.24)보다 낮습니다.

아래 생성 예제의 출력: 4K, 16:9(축소 표시). 프롬프트: Generate an image of a futuristic city skyline at sunset, highly detailed, with the words "NEO TOKYO" in a clean sans-serif font on a billboard.
파라미터와 제한
사고와 검색 그라운딩은 Pro만의 기능이 아닙니다. Nano Banana 2도 둘 다 지원하며, 이미지 검색 그라운딩과 512px 출력이 추가되고 호출당 가격은 더 낮습니다.
Google은 지원 중단 페이지에서
gemini-3-pro-image-preview를 2026년 6월 25일에 종료했다고 밝혔습니다. LaoZhang API에서는 -preview ID가 대응하는 안정 ID로 매핑되지만, 안정 ID인 gemini-3-pro-image를 직접 사용하세요. Pro를 다른 Nano Banana 모델과 비교하려면 Nano Banana 개요를 참고하세요.
호출 전 준비
1
API 키 발급
토큰 관리에서 토큰 생성(创建令牌) 창을 열고, 과금 방식(计费模式)을 사용량 우선(按量优先, 권장) 또는 건당 과금(按次计费)으로 설정한 뒤 생성(创建)을 클릭합니다. Nano Banana Pro에는 호출당 가격만 있어 사용량 과금(按量计费) 키로는 호출할 수 없습니다. 요청이 언제 과금되는지는 Nano Banana 개요의 과금 절에서 설명합니다.

2
키 설정과 의존성 설치
3
cURL용 저장 함수 추가
cURL 예제에는 응답에 이미지가 없으면 이 함수는 대신
jq가 필요합니다. 아래 셸 함수를 정의해 두면 Gemini 네이티브 응답의 마지막 이미지(중간 이미지가 함께 오더라도 최종 결과)를 mimeType에 맞는 확장자로 저장합니다.error, promptFeedback, finishReason 필드를 출력합니다.이미지 생성
아래 요청은 4K, 16:9 이미지를 만들어 저장합니다.- cURL
- Python
candidates[0].content.parts[].inlineData.data에 Base64로 들어 있고, 형식은 mimeType으로 알 수 있습니다. 두 예제 모두 이를 디코딩해 형식에 맞는 PNG, JPEG, WebP 파일로 저장합니다.
4K 이미지는 1K보다 오래 걸리므로 클라이언트 타임아웃을 넉넉하게 두세요. 예제는 300초까지 기다립니다.
출력 크기
imageSize는 1K(기본값), 2K, 4K를 받으며 K는 대문자로 씁니다. Google이 Nano Banana Pro에 대해 공개한 픽셀 크기는 다음과 같습니다.
이미지 편집
nano_banana_pro.py로 편집도 할 수 있습니다. 프롬프트 뒤에 이미지 파일을 나열하면 각 파일을 지시문 뒤의 inlineData 파트로 보냅니다.
--ratio를 지정하지 않으면 요청에 종횡비를 설정하지 않으며, Google의 기본 동작은 입력 이미지의 비율을 따르는 것입니다. cURL 편집, 최대 14장 참조 이미지 합성, 공개 URL 입력, 편집 프롬프트 작성법은 Nano Banana Pro 이미지 편집을 참고하세요.
Google 검색으로 이미지 그라운딩
날씨 예보나 최근 사건처럼 최신 정보를 바탕으로 이미지를 만들려면googleSearch 도구를 추가하세요. 이미지와 함께 모델이 쓴 텍스트도 받으려면 responseModalities에 TEXT를 허용합니다.
candidates[0].groundingMetadata에 있습니다. 같은 요청은 모델 ID만 바꾸면 Nano Banana 2.1이나 Nano Banana 2에서도 동작하며, Nano Banana 2 Lite는 그라운딩을 지원하지 않습니다.
그라운딩 결과를 최종 사용자에게 보여 준다면 검색 제안 표시 방법에 대한 Google의 그라운딩 가이드를 따르세요. 그라운딩은 호출당 가격에 더해 검색 1회당 $0.014가 과금됩니다. 검색 횟수는 모델이 정하며, 호출 로그에서 횟수를 볼 수 있습니다. 자세한 내용은 Nano Banana 개요의 과금 절을 참고하세요.
OpenAI 호환 경로 사용
앱이 이미 OpenAI SDK를 쓴다면 chat completions로 Pro를 호출할 수 있습니다. SDK가 키를Authorization: Bearer로 보냅니다. 이 경로에는 종횡비나 크기 설정이 없어서 텍스트만 보내면 1K 1:1 이미지가 반환됩니다. 이미지는 message.content 안에 Base64 데이터 URL로 들어옵니다. 아래 스크립트를 nano_banana_pro_chat.py로 저장하세요.
프롬프트 작성 팁
- 키워드 나열 대신 피사체, 배경, 스타일, 조명, 카메라 각도를 완전한 문장으로 설명하세요.
- 이미지 안의 텍스트는 정확한 문구를 따옴표로 묶고 글꼴 스타일을 적으세요.
- 원하지 않는 것보다 원하는 것을 설명하세요. “자동차 없음”보다 “텅 빈 거리”가 더 잘 동작합니다.
- 모델이 텍스트로만 답하지 않도록 “이미지를 생성해 주세요”라고 명시하세요.
오류와 과금
Pro가 받는 값을 보내세요.- Google은
4k처럼 소문자로 쓴 크기를 거부합니다. - 프롬프트가 이미지를 요청하지 않았거나 안전 검사가 출력을 차단한 경우처럼, 이미지 없이 HTTP 200이 반환될 수 있습니다. 이때도 한 번 과금됩니다.
finishReason(있다면promptFeedback도)을 확인하고 프롬프트나 참조 이미지를 바꾼 뒤 다시 보내세요. Nano Banana 개요의 빈 응답 과금 피하기 절을 참고하세요. - HTTP 401은 키 또는
Authorization: Bearer헤더가 잘못되었다는 뜻입니다. 429와 5xx 응답은 백오프를 두고 재시도하고, 타임아웃이 난 요청은 다시 보내기 전에 호출 로그를 확인하세요.
자주 묻는 질문
Nano Banana Pro 4K는 Google과 비교해 얼마인가요?
LaoZhang API는 1K, 2K, 4K 모두 이미지당 $0.09이며 생성과 편집이 같습니다. Google 표준 가격은 1K·2K가 $0.134, 4K가 $0.24이므로 4K 이미지는 여기서 약 62% 저렴합니다. 최신 가격은 모델 및 가격에서 확인하세요. 업스트림의 200이 아닌 응답은 과금되지 않고, 이미지 없는 HTTP 200은 한 번 과금됩니다. 과금과 실패 처리를 참고하세요.일괄 생성에도 속도 제한이 걸리나요?
아니요. 키 하나에 RPM(분당 요청 수), IPM(분당 이미지 수), 동시 요청 상한이 없고, 요청은 여러 Google 공식 경로로 자동 전환됩니다. 가끔 나오는429는 업스트림 용량 때문이며 과금되지 않습니다. 잠시 기다린 뒤 다시 시도하세요. 동시 요청과 429를 참고하세요.
Pro와 Nano Banana 2 중 무엇을 쓸까요?
대부분의 작업은 Nano Banana 2.1(호출당 $0.045)이나 Nano Banana 2로 시작하세요. 같은 요청을 받고 호출당 가격이 더 낮으며, 종횡비 4종과 이미지 검색 그라운딩이 추가되고 객체 참조 10장과 캐릭터 참조 4장을 쓸 수 있습니다. Nano Banana 2는 512px 출력도 제공합니다. 결과가 세계 지식, 현지화된 텍스트, 정확한 브랜드 디테일에 달려 있거나, 편집에 스타일 참조(최대 3장)나 캐릭터 참조 최대 5장이 필요하다면 Pro를 고르세요. 워크로드를 바꾸기 전에 직접 쓰는 프롬프트로 두 모델을 비교해 보세요. Nano Banana 2.1 가이드의 생성 프롬프트를 2026년 10월 14일에 두 모델에 2K, 16:9로 보냈을 때 Pro는 69초, Nano Banana 2.1은 25초 만에 반환했습니다.
Nano Banana Pro, 2K, 16:9: 69초, $0.09

Nano Banana 2.1, 2K, 16:9: 25초, $0.045
사고를 끌 수 있나요? 가격에 영향이 있나요?
끌 수 없습니다. Google에 따르면 Gemini 3 이미지 모델은 기본적으로 사고하며 API로 이를 끌 수 없습니다.thinkingLevel은 Nano Banana 2.1, 2, 2 Lite에만 적용되고 Pro에는 효과가 없습니다.
사고하는 동안 모델은 구도를 시험하는 중간 이미지를 만들고, 이 이미지가 결과와 함께 반환될 수 있습니다. 마지막 이미지가 최종 결과입니다. 처리 방법은 Nano Banana 개요의 자주 묻는 질문에 있는 요청 한 번에 이미지 여러 장을 받을 수 있는지에 대한 답을 참고하세요.
Pro는 건당 과금이라 사고량이 가격에 영향을 주지 않습니다.
이미지 안의 텍스트를 정확하게 얻으려면 어떻게 하나요?
Google은 텍스트를 먼저 생성한 다음, 그 텍스트가 들어간 이미지를 요청하라고 권장합니다. 위 프롬프트 작성 팁처럼 정확한 문구를 따옴표로 묶고 위치와 글꼴 스타일을 적으세요. 그래도 어떤 단어가 틀리게 나오면 결과를 입력으로 다시 보내 해당 텍스트만 바꿔 달라고 요청하세요.관련 페이지와 출처
- Nano Banana Pro 이미지 편집 — 이미지 편집과 최대 14장 참조 이미지 합성
- Nano Banana 개요 — 5종 모델, 두 프로토콜, 과금 비교
- Nano Banana 2 — 512px~4K 출력, 종횡비 14종, 이미지 검색 그라운딩
- Nano Banana 2 Lite — 저비용 1K 이미지
- Google: Nano Banana image generation — Gemini 3 Pro Image의 크기, 종횡비, 사고, 텍스트 렌더링 조언
- Google: generateContent reference —
imageConfig필드 - Google: Gemini API deprecations — 업스트림 모델 종료일
- 호출 로그 — 요청별 상태와 청구 금액 확인