메인 콘텐츠로 건너뛰기
Nano Banana Pro는 Google이 가장 복잡한 시각 작업용으로 내놓은 모델로, 이 시리즈에서 세계 지식이 가장 넓고 현지화, 브랜드 일관성, 세밀한 창작 제어를 지원합니다. LaoZhang API에서는 1K, 2K, 4K 모두 이미지당 $0.09이므로, 4K는 Google 표준 가격 $0.24의 40%에도 못 미칩니다. 동시 요청 상한이나 속도 제한이 없고, 요청은 여러 Google 공식 경로로 자동 전환됩니다.

Nano Banana Pro 지원 범위

공개 가격은 2026년 9월 24일 기준이며 2026년 10월 10일에 확인했습니다. 최신 가격은 모델 및 가격에서 볼 수 있습니다. 이 모델은 Google 공식 채널에서 제공되고, 건당 과금 경로는 가격이 하나이며 모든 크기에서 Google 표준 가격(1K·2K $0.134, 4K $0.24)보다 낮습니다.
Nano Banana Pro로 생성한, NEO TOKYO 광고판이 있는 해 질 녘 미래 도시 스카이라인

아래 생성 예제의 출력: 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 개요의 과금 절에서 설명합니다.LaoZhang API 콘솔의 토큰 생성 창. 과금 방식이 건당 과금(按次计费)으로 설정되어 있음
2

키 설정과 의존성 설치

3

cURL용 저장 함수 추가

cURL 예제에는 jq가 필요합니다. 아래 셸 함수를 정의해 두면 Gemini 네이티브 응답의 마지막 이미지(중간 이미지가 함께 오더라도 최종 결과)를 mimeType에 맞는 확장자로 저장합니다.
응답에 이미지가 없으면 이 함수는 대신 error, promptFeedback, finishReason 필드를 출력합니다.

이미지 생성

아래 요청은 4K, 16:9 이미지를 만들어 저장합니다.
이미지는 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로 저장하세요.
포스터를 생성합니다.
이 경로로 이미지를 보내 편집하려면 편집 가이드의 OpenAI 호환 경로 절을 참고하세요.

프롬프트 작성 팁

  • 키워드 나열 대신 피사체, 배경, 스타일, 조명, 카메라 각도를 완전한 문장으로 설명하세요.
  • 이미지 안의 텍스트는 정확한 문구를 따옴표로 묶고 글꼴 스타일을 적으세요.
  • 원하지 않는 것보다 원하는 것을 설명하세요. “자동차 없음”보다 “텅 빈 거리”가 더 잘 동작합니다.
  • 모델이 텍스트로만 답하지 않도록 “이미지를 생성해 주세요”라고 명시하세요.

오류와 과금

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로 생성한, 비 온 뒤 해 질 녘 BANANA CAFE 네온 간판과 돌바닥 거리가 있는 벽돌 길모퉁이 카페

Nano Banana Pro, 2K, 16:9: 69초, $0.09

Nano Banana 2.1로 생성한, 비 온 뒤 해 질 녘 노란색과 빨간색 BANANA CAFE 네온 간판이 있는 길모퉁이 카페

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은 텍스트를 먼저 생성한 다음, 그 텍스트가 들어간 이미지를 요청하라고 권장합니다. 위 프롬프트 작성 팁처럼 정확한 문구를 따옴표로 묶고 위치와 글꼴 스타일을 적으세요. 그래도 어떤 단어가 틀리게 나오면 결과를 입력으로 다시 보내 해당 텍스트만 바꿔 달라고 요청하세요.

관련 페이지와 출처