나노 바나나 프로/나노 바나나 2 API 사용 방법 — 개발자를 위한 단계별 가이드

“Nano Banana Pro API”를 검색해 보셨다면, 가장 먼저 헷갈리는 부분은 바로 이름일 것입니다. 제품명은 Nano Banana Pro입니다. 코드에서 실제로 사용하는 API 이름은 gemini-3-pro-이미지. 이 점만 명확해지면, 나머지 설정 과정은 훨씬 덜 복잡해집니다.

텍스트 가독성, 제품 상세 정보, 브랜드 관련 요소, 현지화된 레이아웃, 또는 세부 제약 사항이 많은 시각적 기획서 등 이미지의 일관성을 유지해야 할 때는 Nano Banana Pro를 사용하세요. 만약 여전히 같은 아이디어로 10가지 버전을 시도하고 있다면, 먼저 Nano Banana 2로 시작하고, 방향성이 더 많은 투자를 할 가치가 있다고 판단될 때 Pro로 전환하세요.

만약 여러분의 팀이 앱을 출시하기보다는 여전히 프롬프트를 다듬고 있다면, GlobalGPT의 Nano Banana Pro 작업 공간 개발자가 공식 API를 연동하기 전에 출력 결과를 비교해 볼 수 있는 실용적인 공간입니다. 이는 창의적인 워크플로우 단축 경로일 뿐, Google의 API 콘솔, 청구, 로그 또는 엔터프라이즈 제어 기능을 대체하는 것은 아닙니다.

간단한 답변

API를 통해 Nano Banana Pro를 사용하려면 Google AI Studio 또는 Google Cloud 프로젝트를 생성하고, Gemini API 키를 생성한 다음, Google Gen AI SDK를 설치하고 호출하십시오. gemini-3-pro-이미지. 먼저 일반 텍스트-이미지 변환 요청 하나부터 시작해 보세요. API를 구축하기 전에 여전히 접근 권한을 확인하고 있다면, Gemini 3 Pro 무료 체험판 사용 안내 읽기에 좋은 참고서입니다.

Nano Banana Pro API가 실제로 무엇인지

Nano Banana Pro는 Gemini 이미지 제품군에 속하는 구글의 프리미엄 네이티브 이미지 생성 모델입니다. 개발자 문서에서 구글은 이를 제미니 3 프로 이미지. 그렇기 때문에 모델명이 마케팅 명칭과 다르게 보입니다.

이 API는 텍스트를 바탕으로 이미지를 생성하거나, 하나 이상의 참조 이미지를 활용하거나, 작성된 지침에 따라 기존 이미지를 편집할 수 있습니다. 따라서 제품 모형, 광고 변형, 도표, 현지화된 광고 소재, 그리고 이미지 내 텍스트의 가독성을 유지해야 하는 이미지 작업 흐름에 유용합니다. 코딩 없이 탐색해 보려면, GlobalGPT 이미지 생성기 창의적인 방향을 먼저 시험해 보기에 더 쉬운 곳입니다.

나노 바나나 프로 vs 나노 바나나 2

어떤 이름을 선택할지는 이름이 얼마나 새롭게 들리는지보다는 작업의 어느 단계에 있는지에 더 달려 있습니다. ‘Pro’는 꼼꼼하게 검토하는 단계에 적합합니다. ‘Nano Banana 2’는 엉성한 초안 작성 단계에 적합합니다. 만약 더 빠른 방식이 필요하다면, 다음 내용을 읽어보세요. Nano Banana 2 무료 체험 가이드 Pro를 중심으로 전체 워크플로를 설계하기 전에.

실제 진입점을 사용하여 API 설정하기

프로토타입의 경우, Google AI Studio가 대개 가장 빠른 방법입니다. 기업용 앱의 경우, 특히 공유 청구, 액세스 제어, 로깅 또는 Vertex AI 거버넌스가 필요한 경우에는 팀이 이미 신뢰하고 있는 Google Cloud 환경을 사용하세요. 액세스 결정이 실제로 Google 요금제 등급에 따른 것이라면, 다음에서 각 옵션의 장단점을 비교해 보세요. Google AI Plus와 Pro 비교 가이드 API 설정을 유일한 문제로 간주하기 전에.

공개 문서는 가장 명확한 첫 번째 참고 자료입니다. 이를 통해 현재 Nano Banana 이미지 생성 페이지에 있는지 확인하고, 해당 페이지가 권장되는 Interactions API 경로를 사용하고 있는지 점검한 뒤, 거기서 API 키나 AI Studio 진입점으로 바로 이동할 수 있습니다.

1. Google AI Studio 또는 Google Cloud 프로젝트를 생성하거나 엽니다.
2. Gemini API 키를 생성합니다.
3. 키를 서버 측 환경 변수로 저장하십시오.
4. 백엔드 프로젝트에 Google Gen AI SDK를 설치하세요.
5. 참조 이미지나 사용자용 기능을 추가하기 전에 저해상도 테스트를 한 번 실행해 보세요.

API 키 페이지 역시 공개되어 있지만, 키를 생성하거나 확인하는 것은 사용자의 Google 계정 및 프로젝트 권한에 따라 달라집니다. 핵심은 해당 키를 프론트엔드 자바스크립트에 노출하지 않는 것입니다. 브라우저나 모바일 앱은 백엔드를 호출해야 하며, 백엔드는 Gemini를 호출해야 합니다.

로그인 후, AI Studio의 직접 URL을 입력하면 Playground로 이동하며 나노 바나나 프로 로 선정됨 gemini-3-pro-이미지. 이 기사에서 AI Studio는 또한 실제 사용 시 주의해야 할 점도 언급했는데, Nano Banana Pro를 Playground에서 실행하려면 Google AI 플랜이나 API 키가 필요하다는 점입니다.

그리고 코드 받기 이 시점에서 해당 버튼을 확인해 볼 가치가 여전히 있습니다. 이 버튼을 누르면 개발자 워크플로우에 진입했음을 확인할 수 있지만, 해당 계정의 모델이 잠겨 있는 경우 코드 패널이 실행 가능한 스니펫이 완전히 포함되지 않은 상태로 열릴 수 있습니다. 이는 설정 관련 신호일 뿐, 프롬프트 오류가 아닙니다.

export GEMINI_API_KEY="YOUR_API_KEY"

첫 번째 이미지 생성하기

첫 번째 요청은 의도적으로 간단하게 구성해야 합니다. 인증, 모델 접근, 응답 형식, 파일 처리를 확인하는 단계입니다. 복잡한 프롬프트 작업은 시스템이 완전히 정비될 때까지 미루어도 됩니다.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "흰색 책상 위에 놓인 스테인리스 스틸 여행용 머그잔의 깔끔한 제품 모형을 만들어 주세요."
 "읽기 쉬운 "MORNING LAB" 라벨을 추가해 주세요."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

이 프롬프트는 가독성 좋은 텍스트가 포함된 간단한 제품 모형을 요청합니다. 이를 통해 실제 작업에서 중요한 세 가지 요소, 즉 사물의 사실성, 구도, 그리고 모델이 짧은 텍스트를 선명하게 표현할 수 있는지 여부를 빠르게 파악할 수 있습니다. 자격 증명을 건드리지 않고 프롬프트를 조정하려면, 다음에서 동일한 브리프를 시도해 보세요. GlobalGPT의 Nano Banana Pro 작업 공간 먼저.

참고 문헌을 포함한 이미지 편집

참조 기반 편집은 Nano Banana Pro가 진가를 발휘하기 시작하는 부분입니다. 처음부터 새로운 이미지를 요청하는 대신, 모델에게 이미지를 제공하고 무엇이 변경될 수 있고 무엇이 그대로 유지되어야 하는지 정확히 지시하면 됩니다.

개발자가 아니신 경우, 이 블록을 직접 실행해야 할 내용이 아니라 워크플로우의 예시로만 참고하시기 바랍니다. 파일 이름 product-reference.png 이는 단순히 “기존 제품 이미지”를 의미합니다. 만약 여러분의 주된 업무가 이미지 모델을 비교하는 것이라면, 더 광범위한 Gemini 3 Pro 대체 제품 비교 테스트 Pro 버전을 사용하기 위해 추가 설정을 거치는 것이 과연 가치가 있는지 판단하는 데 도움이 될 수 있습니다.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "머그잔의 모양, 손잡이, 로고 위치는 그대로 유지해 주세요. "
            "배경을 밝은 주방 조리대로 바꾸고, 따뜻한 아침 햇살을 더하며, "
 "모든 텍스트는 선명하고 읽기 쉽게 유지해 주세요."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

좋은 편집 지침은 마치 디자이너에게 주는 피드백과 비슷합니다. “이 부분은 그대로 두고, 저 부분은 수정하고, 로고는 옮기지 말고, 텍스트는 가독성을 유지해 주세요’와 같은 식이죠. ”고급스럽게 만들어 주세요”와 같은 모호한 지침은 모델이 추측해야 할 부분이 너무 많아 작업 낭비를 초래하기 쉽습니다.

가격 책정 및 원가 관리

고정 예산 수치를 공개하기 전에 구글의 가격 페이지를 신뢰할 수 있는 정보원으로 활용하세요. 2026년 7월 21일 확인된 바와 같이, 구글은 ‘Nano Banana Pro’를 ‘Gemini 3 Pro Image’ 항목 아래에 나열하고 있으며, 텍스트/사고 처리 비용과 이미지 출력 비용을 별도로 구분하고 있습니다.

API 이미지 출력 비용, 2026년 7월 21일 확인

실제 비용 구조는 간단합니다. 초안은 저렴하게 작성하고, 마무리 작업은 꼼꼼하게 하세요. 초기 변형 작업은 Nano Banana 2에 맡기고, 최종 이미지를 생성할 때는 가장 강력한 프롬프트와 참조 자료를 Nano Banana Pro로 보내세요. 또한 사용자 등급별로 해상도를 제한하고, 프롬프트가 변경되지 않았을 때는 중복 생성을 피하세요. 제품 측의 초안 작성 라인을 원한다면, Nano Banana 2 in GlobalGPT 먼저 테스트해 볼 만한 더 가벼운 옵션입니다.

제작 노트

사용자가 귀사의 제품을 통해 이미지를 생성할 수 있게 되면, 이에 대한 안전 장치가 필요합니다. 이미지 API는 비용이 급격히 증가할 수 있으며, 오류 발생 시 제공업체의 세부 정보를 노출하지 않으면서도 그 원인을 명확히 설명할 수 있어야 합니다. 유료 AI 접근 권한이 필요한 사용자를 아직 결정하지 못한 팀은 또한 ChatGPT 사업 계획서 작성 가이드.

• 키를 서버 측에 보관하세요: 브라우저나 모바일 클라이언트에서 Gemini API 키를 전송하지 마십시오.
• 디버깅에 충분한 로그를 기록하십시오: 모델 ID, 프롬프트 해시, 출력 크기, 지연 시간, 사용자 ID 및 결과 상태.
• 할당량 설정: 사용자, 작업 공간 및 청구 기간별 이미지 수를 제한합니다.
• 주의 깊게 다시 시도하세요: 일시적인 오류는 재시도하되, 정책 또는 할당량 오류는 반복적으로 재시도하지 마십시오.
• 저장 규칙을 정하세요: 생성된 이미지와 업로드된 참고 자료를 얼마나 오래 보관하는지 알고 계십니까?.
• 유용한 오류 메시지를 표시하세요: 사용자에게 문제가 액세스, 파일 형식, 할당량, 또는 프롬프트 정책 중 어느 것 때문인지 알려주십시오.

GlobalGPT의 활용 분야

GlobalGPT는 API 빌드 전이나 그 옆에 배치하는 것이 가장 적합합니다. 설계자는 Nano Banana Pro와 나노 바나나 2, GPT Image, Flux 및 기타 이미지 모델들을 하나의 작업 공간에서 통합한 다음, 가장 효과적인 프롬프트 패턴을 개발자에게 전달합니다.

공식 API 키, 결제, 로그, 엔터프라이즈 액세스 또는 Vertex AI 라우팅을 이용하려면 Google 개발자 플랫폼을 계속 사용하세요. 프롬프트 개발 시 창의적인 아이디어를 더 빠르게 비교하고 탭 수를 줄이려면, GlobalGPT의 이미지 생성기 작업 공간 초기 작업이 덜 어색해지도록 할 수 있다.

자주 묻는 질문

Nano Banana Pro API는 Gemini 3 Pro Image와 같은 것입니까?

개발자 작업용으로는 그렇습니다. 구글은 Nano Banana Pro를 Gemini 3 Pro Image로 명시하고 있으며, API 모델 ID는 gemini-3-pro-이미지.

Nano Banana Pro와 Nano Banana 2 중 어떤 것을 사용해야 할까요?

더 정밀한 제어, 가독성 높은 텍스트, 참조 정보 또는 브랜드 일관성이 필요한 최종 이미지에는 Nano Banana Pro를 사용하세요. 더 빠른 초안 작업과 비용 효율적인 반복 작업에는 Nano Banana 2를 사용하세요.

프론트엔드 자바스크립트에서 Nano Banana Pro를 직접 호출할 수 있나요?

아니요. API 키는 서버 측에 보관하고, 요청을 백엔드를 통해 라우팅한 다음, Gemini API로 요청을 전송하기 전에 사용자 할당량을 적용하십시오.

GlobalGPT가 공식 Google API를 대체하나요?

No. GlobalGPT는 프롬프트 테스트 및 다양한 모델 간의 창의성 비교에 유용하지만, 공식 API 키, 결제, 로그 및 엔터프라이즈 제어 기능은 Google 개발자 플랫폼에서 제공됩니다.

Nano Banana Pro API 비용은 어떻게 산정해야 하나요?

Google의 최신 Gemini API 요금 페이지를 참고하여 모델, 출력 해상도, 이미지 양에 따라 비용을 산정해 보세요. 비용 관리의 일반적인 방식은 먼저 비용이 저렴한 모델로 초안을 작성한 다음, 선별된 최종 자산에 대해 Nano Banana Pro를 사용하는 것입니다.