Nano Banana Pro 개발자를 위한 완벽 가이드

@GoogleAIStudio
영어8개월 전 · 2025년 11월 22일
728K
3.6K
588
58
5.0K

TL;DR

개발자가 Nano Banana Pro (Gemini 3 Pro Image)를 활용하기 위한 포괄적인 가이드로, Gemini API를 통한 검색 그라운딩, 4K 해상도, 고급 이미지 믹싱 튜토리얼을 제공합니다.

차세대 AI 모델의 고급 기능(사고, 검색 기반, 놀라운 4K 출력 등)이 어떻게 복잡하고 창의적인 애플리케이션을 구축할 수 있게 해주는지 알아보세요.

Flash 모델(Nano Banana)이 속도와 경제성을 제공했다면, Pro 버전은 "사고" 기능, 검색 기반, 그리고 고품질 4K 출력을 도입합니다. 이제 복잡한 창의적 작업을 마음껏 해볼 시간입니다!

이 가이드에서는 Gemini 개발자 API를 사용하여 Nano Banana Pro의 고급 기능을 살펴보겠습니다.

이 가이드에서 다루는 내용:

**1. Google AI Studio에서 Nano Banana Pro 사용하기

  1. 프로젝트 설정
  2. 클라이언트 초기화
  3. 기본 생성 (기본)
  4. "사고" 프로세스
  5. 검색 기반
  6. 고해상도 4K 생성
  7. 다국어 지원
  8. 고급 이미지 합성
  9. Pro 전용 데모
  10. 모범 사례 및 프롬프팅 팁

참고



: 이 게시물의 대화형 버전을 보려면


Python Cookbook

또는 AI Studio의


Javascript Notebook

을 확인하세요.

1. Google AI Studio에서 Nano Banana Pro 사용하기

최종 사용자는 Gemini 앱에서 Nano Banana Pro에 액세스할 수 있지만, 개발자가 프로토타입을 만들고 프롬프트를 테스트하기에 가장 좋은 환경은 Google AI Studio입니다. AI Studio는 코드를 작성하기 전에 사용 가능한 모든 AI 모델을 실험해볼 수 있는 플레이그라운드이자 Gemini API로 빌드하기 위한 진입점이기도 합니다.

AI Studio 내에서 Nano Banana Pro를 사용할 수 있습니다. 시작하려면 aistudio.google.com으로 이동하여 Google 계정으로 로그인하고 모델 선택기에서 Nano Banana Pro (Gemini 3 Pro Image)를 선택하세요.

Nano-Banana와 달리 프로 버전은 무료 티어가 없습니다. 즉, 결제가 활성화된 API 키를 선택해야 합니다 (아래 "프로젝트 설정" 섹션 참조).

Google AI Studio - inline image



: AI Studio에서 바로 Nano Banana 웹 앱을 코드로 만들 수도 있습니다.


ai.studio/apps

에서 확인하거나,


기존 앱

중 하나를 탐색하여 리믹스해보세요.

2. 프로젝트 설정

이 가이드를 따라 하려면 다음이 필요합니다:

이미 하드코어 Gemini API 사용자로서 모든 것을 갖추고 있다면, 좋습니다! 이 섹션은 건너뛰고 다음으로 넘어가세요. 그렇지 않다면, 시작하는 방법은 다음과 같습니다:

A단계: API 키 받기

AI Studio에 처음 로그인하면 Google Cloud 프로젝트와 API 키가 자동으로 생성됩니다.

API 키 관리 화면을 열고 "복사" 아이콘을 클릭하여 API 키를 복사하세요.

Google AI Studio - inline image

B단계: 결제 활성화

Nano Banana Pro는 무료 티어가 없으므로 Google Cloud 프로젝트에서 결제를 활성화해야 합니다.

API 키 관리 화면에서 프로젝트 옆에 있는 결제 설정을 클릭하고 화면의 지침을 따르세요.

Google AI Studio - inline image

Nano Banana Pro의 가격은 얼마인가요?

Nano Banana Pro를 사용한 이미지 생성은 Flash 버전보다 비싸며, 특히 4K 이미지의 경우 더욱 그렇습니다. 이 게시물이 게시된 시점 기준으로 1K 또는 2K 이미지 비용은 $0.134이고, 4K 이미지 비용은 $0.24입니다 (입력 및 텍스트 출력의 토큰 비용 추가).

최신 정보는 문서의 가격 정책을 확인하세요.

전문가 팁



: 생성 비용을 50% 절약하려면


Batch API

를 사용하세요. 그 대신 이미지를 받기까지 최대 24시간을 기다려야 할 수 있습니다.

C단계: SDK 설치

선호하는 언어에 맞는 SDK를 선택하세요.

Python:

text
1pip install -U google-genai
2# 이미지 처리를 위한 Pillow 라이브러리 설치
3pip install Pillow

JavaScript / TypeScript:

text
1npm install @google/genai

참고



: 다음 예제는 데모를 위해 Python SDK를 사용합니다. JavaScript에서 Nano Banana를 사용하는 동등한 코드 조각은 이


JS Notebook

에서 제공됩니다.

3. 클라이언트 초기화

Pro 모델을 사용하려면 gemini-3-pro-image-preview 모델 ID를 사용해야 합니다.

python
1from google import genai
2from google.genai import types
3
4# 클라이언트 초기화
5client = genai.Client(api_key="YOUR_API_KEY")
6
7# 모델 ID 설정
8PRO_MODEL_ID = "gemini-3-pro-image-preview"

4. 기본 생성 (기본)

멋진 기능을 살펴보기 전에, 표준 생성을 살펴보겠습니다. response_modalities (텍스트와 이미지 또는 이미지만 얻기 위해)와 aspect_ratio를 사용하여 출력을 제어할 수 있습니다.

python
1prompt = "녹색 왼쪽 눈과 파란색 오른쪽 눈을 가진 샴 고양이의 포토리얼리스틱 이미지를 만들어주세요"
2aspect_ratio = "16:9" # "1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9" 또는 "21:9"
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'], # 또는 ['Image'] 만
9 image_config=types.ImageConfig(
10 aspect_ratio=aspect_ratio,
11 )
12 )
13)
14
15# 이미지 표시
16for part in response.parts:
17 if image:= part.as_image():
18 image.save("cat.png")
Google AI Studio - inline image

채팅 모드도 사용 가능합니다 (사실 다중 턴 편집을 위해 이 방식을 추천합니다). 8번째 예제인 "Polyglot Banana"를 확인해보세요.

5. "사고" 프로세스

Nano Banana Pro는 단순히 그림을 그리는 것이 아닙니다. 생각합니다. 즉, 가장 복잡하고 기발한 프롬프트를 이미지를 생성하기 전에 추론할 수 있습니다. 그리고 가장 좋은 점은 그 사고 과정을 들여다볼 수 있다는 것입니다!

이 기능을 활성화하려면 thinking_config에서 include_thoughts=True를 설정하세요.

python
1prompt = "비현실적이지만 현실적이고 바이럴될 가능성이 있는 이미지를 만들어주세요"
2aspect_ratio = "16:9"
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'],
9 image_config=types.ImageConfig(
10 aspect_ratio=aspect_ratio,
11 ),
12 thinking_config=types.ThinkingConfig(
13 include_thoughts=True # 생각 활성화
14 )
15 )
16)
17
18# 이미지와 생각 표시
19for part in response.parts:
20 if part.thought:
21 print(f"생각: {part.text}")
22 elif image:= part.as_image():
23 image.save("viral.png")

그러면 다음과 같은 결과를 얻을 수 있습니다:

text
1## 라마 출근족 상상하기
2
3지금은 라마에 집중하고 있습니다. 목표는 라마를
4볼리비아 라파스의 분주한 버스 안에서 매일 출근하는
5모습으로 포착하는 것입니다. 제 계획에는 웃긴 승객들로 가득한
6빈티지 버스가 포함됩니다. 이미지는 한 라마가 창밖을 바라보고,
7다른 라마가 승객과 상호작용하는 동안 사람들이 사진을
8찍는 모습 같은 세부 사항을 강조할 것입니다.
9
10[IMAGE]
11
12## 개념 시각화하기
13
14이제 요청된 시나리오에 완전히 몰입했습니다. 제 주요
15초점은 "비현실적이면서도 현실적인" 측면에 맞춰져 있습니다.
16주요 요소가 설정되면서 장면이 구체화되기 시작했습니다.
Google AI Studio - inline image

이러한 투명성은 모델이 사용자의 요청을 어떻게 해석했는지 이해하는 데 도움이 됩니다. 마치 아티스트와 대화하는 것과 같습니다!

6. 검색 기반 (실시간 마법)

가장 획기적인 기능 중 하나는 검색 기반(Search Grounding) 입니다. Nano Banana Pro는 과거에 머물러 있지 않습니다. Google 검색의 실시간 데이터에 액세스하여 정확하고 최신의 이미지를 생성할 수 있습니다. 날씨를 원하시나요? 준비됐습니다.

예를 들어, 현재 일기 예보를 시각화하도록 요청할 수 있습니다:

python
1prompt = "도쿄의 향후 5일간 현재 일기 예보를 깔끔하고 현대적인 기상 차트로 시각화해주세요. 각 날짜에 무엇을 입어야 할지에 대한 시각적 정보도 추가해주세요"
2
3response = client.models.generate_content(
4 model=PRO_MODEL_ID,
5 contents=prompt,
6 config=types.GenerateContentConfig(
7 response_modalities=['Text', 'Image'],
8 image_config=types.ImageConfig(
9 aspect_ratio="16:9",
10 ),
11 tools=[{"google_search": {}}] # Google 검색 활성화
12 )
13)
14
15# 이미지 저장
16for part in response.parts:
17 if image:= part.as_image():
18 image.save("weather.png")
19
20# 출처 표시 (항상 해야 합니다)
21print(response.candidates[0].grounding_metadata.search_entry_point.rendered_content)
Google AI Studio - inline image

7. 크게 가거나 집에 가거나: 4K 생성

인쇄 품질의 이미지가 필요하신가요? Nano Banana Pro는 4K 해상도를 지원합니다. 때로는 큰 것이 더 좋으니까요.

python
1prompt = "모든 계절을 겪고 있는 떡갈나무의 사진"
2resolution = "4K" # 옵션: "1K", "2K", "4K", 소문자는 작동하지 않으니 주의하세요.
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'],
9 image_config=types.ImageConfig(
10 aspect_ratio="1:1",
11 image_size=resolution
12 )
13 )
14)
Google AI Studio - inline image

참고



: 4K 생성은 더 높은 비용이 발생하므로 현명하게 사용하세요!

8. 폴리글랏 바나나 (다국어 지원)

이 모델은 이미지 내 텍스트를 12개 이상의 언어로 생성하고 번역할 수도 있습니다. 말 그대로 눈을 위한 만능 번역기입니다.

python
1# 스페인어로 인포그래픽 생성
2message = "스페인어로 6학년 학생에게 적합한 아인슈타인의 일반 상대성 이론을 설명하는 인포그래픽을 만들어주세요"
3
4response = chat.send_message(message,
5 config=types.GenerateContentConfig(
6 image_config=types.ImageConfig(aspect_ratio="16:9")
7 )
8)
9
10# 이미지 저장
11for part in response.parts:
12 if image:= part.as_image():
13 image.save("relativity.png")
Google AI Studio - inline image
python
1# 일본어로 번역
2message = "이 인포그래픽을 일본어로 번역하고, 다른 모든 것은 그대로 유지해주세요"
3response = chat.send_message(message)
4
5# 이미지 저장
6for part in response.parts:
7 if image:= part.as_image():
8 image.save("relativity_JP.png")
Google AI Studio - inline image

9. 믹스 앤 매치! (고급 이미지 합성)

Flash 모델이 최대 3개의 이미지를 혼합할 수 있는 반면, Pro 모델은 최대 14개 이미지를 처리할 수 있습니다! 하나의 프롬프트로 완전한 파티를 즐기는 셈이죠. 복잡한 콜라주를 만들거나 전체 제품 라인을 선보이는 데 완벽합니다.

python
1# 여러 이미지 합성
2response = client.models.generate_content(
3 model=PRO_MODEL_ID,
4 contents=[
5 "이 사람들이 우스운 표정을 짓고 있는 사무실 단체 사진",
6 PIL.Image.open('John.png'),
7 PIL.Image.open('Jane.png'),
8 # ... 최대 14개의 이미지 추가 가능
9 ],
10)
11
12# 이미지 저장
13for part in response.parts:
14 if image:= part.as_image():
15 image.save("group_picture.png")
Google AI Studio - inline image

참고



: 캐릭터의 매우 높은 정밀도를 원한다면 5개로 제한하세요. 파티 night에는 충분히 많습니다!

10. 자랑할 시간! (Pro 전용 데모)

다음은 Nano Banana Pro에서만 가능한 몇 가지 예시입니다. 놀랄 준비를 하세요:

개인화된 픽셀 아트 (검색 기반)

프롬프트



: "웹을 검색한 다음, Guillaume Vernade의 경력을 보여주는 등각 투시의 상세한 픽셀 아트 이미지를 생성해주세요"

이는 검색 기반을 사용하여 특정 인물에 대한 정보를 찾고 특정 스타일로 시각화합니다.

Google AI Studio - inline image

복잡한 텍스트 통합

프롬프트



: "소네트가 어떻게 작동하는지에 대한 인포그래픽을 보여주세요. 소네트 안에 바나나에 관한 소네트를 쓰고, 시에 대한 장문의 문학적 분석도 함께 포함해주세요. 좋은 빈티지 미학을 적용해주세요"

모델은 일관된 장문의 텍스트를 생성하고 이를 복잡한 레이아웃에 완벽하게 통합할 수 있습니다.

Google AI Studio - inline image

고품질 목업

프롬프트



: "TCG 플레이어에 관한 브로드웨이 쇼 프로그램의 사진입니다. 멋진 극장 좌석에 놓여 있고, 전문적이고 잘 만들어졌으며 광택이 있습니다. 표지와 무대 사진이 나온 한 페이지가 보입니다."

정확한 조명과 질감을 가진 인쇄 자료의 포토리얼리스틱 목업을 만듭니다.

Google AI Studio - inline image

11. Nano Banana 및 Nano Banana Pro 모범 사례 및 프롬프팅 팁

Nano Banana 모델로 최상의 결과를 얻으려면 다음 프롬프팅 지침을 따르세요:

초구체적으로 작성하세요: 주제, 색상, 조명, 구성에 대해 더 많은 세부 정보를 제공할수록 출력을 더 잘 제어할 수 있습니다.

맥락과 의도를 제공하세요: 이미지의 목적이나 원하는 분위기를 설명하세요. 모델의 맥락 이해는 창의적인 선택에 영향을 미칩니다.

반복하고 개선하세요: 첫 번째 시도에 완벽함을 기대하지 마세요. 모델의 대화 기능을 사용하여 점진적으로 변경하고 이미지를 개선하세요.

단계별 지침을 사용하세요: 복잡한 장면의 경우 프롬프트를 명확하고 순차적인 일련의 지침으로 나누세요.

긍정적인 프레이밍을 사용하세요: "자동차 없음"과 같은 부정적인 프롬프트 대신 원하는 장면을 긍정적으로 설명하세요: "교통 흔적이 없는 텅 빈 황량한 거리".

카메라를 제어하세요: "광각 샷", "매크로 샷" 또는 "로우 앵글 원근법"과 같은 사진 및 영화 용어를 사용하여 구성을 지시하세요.

검색 기반을 활용하세요: 모델이 실시간 또는 실제 데이터를 사용하도록 하려면 매우 정확하게 지정하세요. "올랭피크 리옹의 마지막 경기에 대해 웹을 검색하고 인포그래픽을 만들어줘"가 단순히 "OL 마지막 경기 인포그래픽" (여전히 작동해야 하지만, 확실하게 하세요)보다 더 잘 작동합니다.

[Batch API](https://ai.google.dev/gemini-api/docs/image-generation?batch=file#batch-api)를 사용하여 비용을 낮추고 더 많은 할당량을 확보하세요: Batch API는 소규모 또는 대규모 요청 배치를 함께 보내는 방법입니다. 처리되는 데 최대 24시간이 걸릴 수 있지만, 그 대가로 생성 비용을 50% 절약할 수 있습니다. 또한 할당량도 더 높습니다!

모범 사례에 대한 자세한 내용은 문서의 프롬프팅 가이드와 공식 블로그에 게시된 Nano Banana용 프롬프팅 모범 사례를 확인하세요.

마무리

Nano Banana Pro (Gemini 3 Pro Image)는 AI 이미지 생성의 새로운 지평을 엽니다. 생각하고, 검색하고, 4K로 렌더링할 수 있는 능력을 갖춘 이 도구는 진지한 창작자(그리고 진지한 재미)를 위한 도구입니다.

사용해 볼 준비가 되셨나요? Google AI Studio로 이동하여, 을 사용해보거나 맞춤 설정하거나, Cookbook을 확인해보세요.

원클릭 저장

YouMind로 바이럴 글을 AI 심층 읽기

소스를 저장하고, 핵심 질문을 던지고, 주장을 요약해 바이럴 글을 다시 활용할 수 있는 노트로 바꾸세요. 하나의 AI 워크스페이스에서 모두 할 수 있습니다.

YouMind 둘러보기
크리에이터를 위해

당신의 Markdown을 깔끔한 𝕏 글로

직접 쓴 장문을 올릴 때 이미지, 표, 코드 블록을 𝕏에 맞게 정리하는 일은 번거롭습니다. YouMind는 전체 Markdown 초안을 깔끔하고 바로 게시할 수 있는 𝕏 글로 바꿔 줍니다.

Markdown → 𝕏 사용해 보기

분석할 패턴 더 보기

최근 바이럴 아티클

더 많은 바이럴 아티클 보기