Nano Banana API
간결한 REST 엔드포인트와 유연한 화면 비율, 비동기 전달 방식으로 GoEnhance를 통해 텍스트 프롬프트에서 이미지를 생성합니다. GoEnhance는 독립적인 API 접근을 제공하며, Google이 아니고 Google 공식 Gemini API도 아닙니다.
API 키 만들기
개발 워크플로를 위한 텍스트 기반 이미지 생성
전송하기 전에 프롬프트, 비율, 인증, 콜백 설정을 확인합니다.
Nano Banana API 파라미터
엔드포인트
<code>https://api.goenhance.ai/api/v1/nano-banana</code>로 POST 요청을 보냅니다.
인증
<code>Authorization</code> 헤더에 GoEnhance API 자격 증명을 포함합니다.
프롬프트
생성하려는 이미지를 설명하는 필수 텍스트 프롬프트를 입력합니다.
출력 비율
<code>auto</code>, <code>1:1</code>, <code>16:9</code>, <code>9:16</code>, <code>4:3</code>, <code>3:4</code>, <code>2:3</code>, <code>3:2</code> 중에서 선택합니다.
콜백 URL
작업 상태 알림을 받을 공개 접근 가능한 HTTPS URL을 선택적으로 지정할 수 있습니다.
비동기 응답
요청이 정상적으로 접수되면 <code>img_uuid</code>가 반환되며, 애플리케이션은 이 값으로 최종 결과를 조회합니다.
문서에 명시된 이미지 단위 과금과 비동기 응답을 기준으로 모든 생성 요청을 설계합니다.
명확한 가격과 작업 처리
이미지당 2 토큰
Nano Banana API 가격은 생성 이미지 1장당 2 토큰이며, GoEnhance 문서 기준으로 장당 $0.04에 해당합니다.
작업 식별자 응답
최종 이미지 결과를 받아올 수 있도록 반환된 <code>img_uuid</code>를 애플리케이션 작업과 함께 저장합니다.
콜백 재시도 동작
콜백이 HTTP 200을 반환하지 않으면 GoEnhance는 알림을 최대 3회까지 재시도하며, 시도마다 타임아웃은 3초입니다.
세 단계로 Nano Banana 연동하기
1
1. 프롬프트 준비
구체적인 생성 프롬프트를 작성하고 지원되는 화면 비율을 고른 뒤, 필요하면 공개 HTTPS 콜백 URL을 설정합니다.
2
2. 전송 후 저장
인증 정보를 담아 JSON 페이로드를 POST하고, 사용자에게 응답하기 전에 반환된
img_uuid를 저장합니다. 3
3. 결과 조회
작업이 성공 또는 실패에 도달할 때까지 작업 상세를 폴링하거나 콜백 이벤트를 검증한 다음, 출력 URL을 저장하거나 실패를 안전하게 안내합니다.
프롬프트 기반 이미지 생성을 제품과 사내 크리에이티브 시스템에 추가합니다.
Nano Banana API 활용 사례
캠페인 크리에이티브
광고, 배너, 시즌 캠페인 콘셉트를 위한 독창적인 비주얼 방향을 생성합니다.
제품 배경 이미지
제품 중심 마케팅 작업에 쓸 장면 콘셉트와 배경을 만듭니다.
에디토리얼 일러스트
글로 정리한 주제를 기사, 가이드, 뉴스레터를 뒷받침하는 이미지로 바꿉니다.
콘텐츠 현지화
현지화한 프롬프트로 해외 캠페인에 맞는 지역별 비주얼 콘셉트를 생성합니다.
크리에이티브 프로토타이핑
최종 프로덕션 디자인을 확정하기 전에 여러 아트 디렉션을 살펴봅니다.
에셋 파이프라인 자동화
프롬프트 생성과 비동기 작업 처리를 반복 가능한 콘텐츠 워크플로에 연결합니다.
가격, 연동, Google API 검색 의도에 대한 실용적인 답변입니다.