나노 바나나 프로 API 액세스 방법

구글이 텍스트-이미지 생성, 이미지 편집, 고급 구도 제어에 탁월한 최첨단 멀티모달 모델인 Gemini 3 Pro Image의 공식 코드명인 Nano Banana Pro를 출시했습니다. 이제 개발자들은 Gemini API를 통해 이 강력한 도구에 프로그래밍 방식으로 접근할 수 있습니다. 작은 구성 세부사항이 통합의 성공 또는 실패를 빠르게 결정하는 경우가 많습니다.

💡

계속하기 전에 Apidog를 무료로 다운로드하세요. Apidog는 Nano Banana Pro API 엔드포인트 테스트를 간소화하고, JSON 페이로드를 검증하며, 추가 코드 작성 없이 응답을 모의(mock)합니다. Apidog는 Gemini API 인증을 원활하게 처리하므로 헤더 디버깅 대신 프롬프트 작성에 집중할 수 있습니다.

버튼

이 가이드에서는 Nano Banana Pro API에 효과적으로 접근하고 사용하는 모든 단계를 안내합니다.

Nano Banana Pro란 무엇이며, 그 API를 사용해야 하는 이유는 무엇인가요?

구글 딥마인드(Google DeepMind)는 Nano Banana Pro를 Gemini 3 Pro 기반 위에 구축했습니다. 이전 모델들이 따라잡을 수 없었던 스튜디오 품질의 이미지 결과물을 제공합니다. 첫째, 이미지 내 텍스트를 놀라운 정확도로 렌더링합니다. 즉, 읽기 쉬운 로고, 다국어 간판, 장면에 완벽하게 어울리는 스타일 서체 등을 생각해 보세요. 다음으로, 최대 14개의 입력 이미지를 블렌딩하는 것을 지원하며 최대 5개의 피사체에 걸쳐 일관성을 유지합니다. 또한 개발자들은 카메라 앵글, 조명, 피사계 심도, 색 보정, 심지어 최대 4K 해상도까지 제어할 수 있습니다.

식물 정보 — 프롬프트: 이 식물에 대한 흥미로운 정보에 초점을 맞춰 인포그래픽을 생성하세요.

더욱이, 이 기능을 활성화하면 모델이 실시간 구글 검색 데이터를 기반으로 생성합니다. 이는 다이어그램, 인포그래픽 또는 제품 목업의 사실적 정확성을 보장합니다. 모든 결과물에는 출처 추적을 위한 SynthID 워터마크가 포함됩니다.

Nano Banana Pro에는 표준 Gemini API를 통해 접근하지만, 특정 모델 식별자(gemini-3-pro-image-preview 또는 그 안정적인 후속 모델)를 선택해야 합니다. 이 방법은 다른 Gemini 변형 모델과의 코드 호환성을 유지하면서 전문가 수준의 이미지 기능을 잠금 해제합니다.

단계별: Gemini API 키 얻기

자격 증명을 얻으려면 다음 단계를 따르세요:

Google AI Studio로 이동하여 Google 계정으로 로그인하세요.

왼쪽 사이드바에서 "API 키 얻기" 버튼을 클릭하세요.

새 키를 생성하거나 기존 키를 사용하세요.

또는 Vertex AI에서:

Vertex AI Studio 대시보드를 엽니다.
"생성형 AI" → "모델 가든"을 선택합니다.
Nano Banana Pro (Gemini 3 Pro Image로 나열됨)를 찾습니다.
"API 활성화"를 클릭하고 자격 증명을 생성합니다.

키를 환경 변수에 안전하게 저장하십시오. 소스 파일에 직접 하드코딩하지 마십시오.

Google AI Studio에서 Nano Banana Pro API 호출 (빠른 시작)

빠른 실험을 위해 Google AI Studio에서 시작하는 경우가 많습니다. 먼저 ai.studio/banana-pro를 방문하세요. 모델 드롭다운에서 "Nano Banana Pro"를 선택합니다.

그런 다음 "API" 탭으로 전환하여 키가 자동으로 채워진 curl 예시를 확인하세요.

다음은 기본적인 curl 요청입니다:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{
        "text": "Generate a 4K photorealistic image of a yellow banana floating in space with Earth in the background, add text overlay: \"Nano Banana Pro\""
      }]
    }],
    "generationConfig": {
      "responseModal": "IMAGE"
    }
  }'

이 엔드포인트는 다른 Gemini 모델과 동일하며, 모델 이름만 변경됩니다.

Nano Banana Pro용 공식 Python SDK 사용하기

대부분의 개발자는 재시도, 스트리밍 및 MIME 유형을 자동으로 처리하는 Python 클라이언트 라이브러리를 선호합니다. 먼저 설치하세요:

pip install -U google-generativeai

라이브러리를 구성하고 이미지를 생성합니다:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel('models/gemini-3-pro-image-preview')

response = model.generate_content(
    "A futuristic cityscape at golden hour with flying cars and the text 'Welcome to 2042' on a billboard, 4K resolution",
    generation_config=genai.types.GenerationConfig(
        response_mime_type="image/png"
    )
)

response.candidates[0].content.parts[0].inline_data.data  # base64 image

다음과 같이 결과물을 저장합니다:

with open("output.png", "wb") as f:
    f.write(response.candidates[0].content.parts[0].inline_data.data)

SDK는 낮은 수준의 세부 사항을 추상화하므로 프롬프트 엔지니어링에 집중할 수 있습니다.

이미지 편집 및 다중 이미지 입력 처리

Nano Banana Pro는 편집 작업에서 탁월한 성능을 발휘합니다. 프롬프트의 일부로 이미지를 업로드할 수 있습니다. 예를 들어:

import PIL.Image

img = PIL.Image.open("reference.jpg")

response = model.generate_content(
    [img, "Edit this photo: change daytime to dramatic sunset, add bokeh effect, keep the subject unchanged"]
)

여러 이미지와 텍스트를 원활하게 결합할 수 있습니다. 모델은 참조 이미지 간에 피사체의 일관성을 유지합니다.

고급 기능: 그라운딩, 안전 설정 및 제어

실시간 사실을 주입하려면 Google 검색 그라운딩을 활성화합니다:

"systemInstruction": {
  "parts": [{"text": "Use search grounding for factual elements"}]
}

카테고리를 차단하거나 허용하도록 안전 설정을 조정합니다:

model = genai.GenerativeModel(
    'models/gemini-3-pro-image-preview',
    safety_settings=[
        {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"}
    ]
)

종횡비와 품질을 지정합니다:

generation_config=genai.types.GenerationConfig(
    candidate_count=1,
    temperature=0.7,
    extra_params={
        "aspect_ratio": "16:9",
        "quality": "highest"
    }
)

Apidog로 Nano Banana Pro API 호출 테스트 및 디버그

수동 curl 명령어는 일회성 테스트에는 효과적이지만, Apidog는 워크플로우를 혁신합니다. 공식 Gemini OpenAPI 사양을 Apidog로 가져오면 Nano Banana Pro 변형을 포함한 모든 엔드포인트가 자동으로 생성됩니다.

다음과 같은 이점이 있습니다:

generateContent 요청의 JSON 스키마를 시각화합니다.
환경(개발/스테이징/운영 키)을 저장합니다.
요청을 연결하고 응답을 단언합니다.
오프라인 개발을 위해 API를 로컬에서 모의(mock)합니다.
20개 이상의 언어로 클라이언트 코드를 즉시 생성합니다.

예를 들어, Apidog에서 새 요청을 생성하고, Gemini 엔드포인트를 붙여넣고, API 키를 헤더로 추가한 다음, 업로드된 이미지와 함께 복잡한 멀티파트 페이로드를 몇 초 만에 보낼 수 있습니다. Apidog는 "전송"을 누르기도 전에 필수 필드를 검증하여 일반적인 400 오류를 방지합니다.

많은 팀이 Gemini API 테스트를 위해 Apidog로 전환한 후 50-70% 더 빠른 반복 주기를 보고합니다.

프로덕션을 위해 Vertex AI에 Nano Banana Pro 배포

엔터프라이즈 사용자는 Vertex AI를 통해 확장합니다. 커스텀 엔드포인트를 생성하세요:

Vertex AI → 모델 가든으로 이동합니다.
"Gemini 3 Pro Image (Nano Banana Pro)"를 배포합니다.
머신 유형과 자동 확장을 구성합니다.
Vertex SDK를 사용하여 예측 엔드포인트를 호출합니다.

이 방법은 Cloud Operations와 통합된 비공개 엔드포인트, 로깅 및 모니터링을 제공합니다.

가격, 요금 제한 및 모범 사례

Nano Banana Pro는 더 높은 컴퓨팅 요구 사항 때문에 가벼운 모델보다 비용이 더 많이 듭니다. 미리보기 기간 동안 요금이 조정될 수 있으므로 Gemini API 가격 페이지에서 최신 요금을 확인하십시오.

재시도를 위해 지수 백오프를 구현하세요. 가능한 경우 일반적인 프롬프트를 캐시하세요. 또한, 사용 사례가 허용하는 경우에만 관련 없는 요청을 일괄 처리하십시오. 이미지 생성은 아직 진정한 일괄 처리를 지원하지 않습니다.

항상 명확하고 구조화된 프롬프트를 포함하십시오. 품질을 극대화하려면 Nano Banana Pro의 공식 프롬프트 가이드를 참조하세요.

일반적인 문제 해결

잘못된 식별자를 사용하면 "모델을 찾을 수 없음" 오류가 발생합니다. 유료 미리보기 단계에서는 gemini-3-pro-image-preview를 대상으로 하는지 확인하세요.

인증 실패의 경우, 키를 다시 생성하고 후행 공백이 없는지 확인하세요. 이미지가 예기치 않게 워터마크 처리된 것처럼 보인다면, 특정 등급에서만 보이는 반짝임이 제거된다는 점을 기억하세요.

결과물이 검열된 것처럼 보인다면, 안전 임계값을 명시적으로 조정하십시오.

결론

이제 Nano Banana Pro API에 효과적으로 접근하고 통합하는 데 필요한 모든 지식을 갖추셨습니다. 즉각적인 결과를 얻으려면 Google AI Studio에서 시작하고, 스크립팅을 위해서는 Python SDK로 전환하며, Apidog를 활용하여 테스트 및 디버깅을 간소화하세요.

Nano Banana Pro라는 이름 아래 Gemini 3 Pro Image 기능이 결합되어 자동화된 디자인, 맞춤형 마케팅 자료, 데이터 시각화 도구를 위한 새로운 가능성을 열었습니다. 이 단계를 구현하고 과감하게 실험하여 애플리케이션이 전문 스튜디오에 필적하는 시각 자료를 생성하는 것을 지켜보세요.

오늘 Apidog를 다운로드하여 Nano Banana Pro 개발을 가속화하세요. 첫 세션 후 생산성 차이가 확연히 드러날 것입니다.

버튼