Nano Banana 2 API
GoEnhance의 독립 API를 통해 Nano Banana 2로 텍스트에서 이미지를 생성합니다. 지원되는 비율과 0.5K–4K 출력 크기를 선택한 다음, 폴링하거나 콜백으로 결과를 받습니다. GoEnhance는 Google이 아니며, 이 엔드포인트는 Google 공식 Gemini API가 아닙니다.
API 키 만들기
유연한 텍스트 기반 이미지 생성
프롬프트와 출력 제어
model에 nano-banana-2를 지정하고 1–2000자 프롬프트를 함께 보냅니다. 문서에 정의된 종횡비, 출력 크기, 선택적 추론 깊이를 고를 수 있습니다.
비동기 작업 전달
제출에 성공하면 img_uuid가 반환됩니다. GET /api/v1/jobs/detail을 폴링하거나 공개적으로 접근 가능한 HTTPS 콜백 URL을 지정해 상태 업데이트를 받으십시오.
생성 작업을 제출하기 전에 정확한 모델 ID와 문서에 정의된 필드를 확인하십시오.
Nano Banana 2 API 파라미터
모델
필수입니다. <code>model</code>을 정확히 <code>nano-banana-2</code>로 설정하십시오.
프롬프트
필수 텍스트 설명이며 1자에서 2000자까지 입력할 수 있습니다.
종횡비
선택 항목인 <code>ratio</code>입니다. 지원되는 값은 auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 21:9, 1:4, 4:1, 1:8, 8:1입니다.
이미지 크기
선택 항목인 <code>image_size</code>의 기본값은 <code>1k</code>이며, 사용할 수 있는 값은 <code>0.5k</code>, <code>1k</code>, <code>2k</code>, <code>4k</code>입니다.
생성 제어 항목
선택 제어 항목으로 <code>web_search</code>와 대소문자를 구분하는 <code>thinking_level</code> 값 <code>High</code> 또는 <code>Minimal</code>이 있습니다.
인증과 콜백
<code>Authorization</code> 헤더를 보내십시오. 선택 항목인 <code>custom_callback_url</code>은 공개적으로 접근 가능한 HTTPS URL이어야 합니다.
가격은 생성된 이미지 단위로 부과되며 요청한 출력 크기에 따라 달라집니다.
Nano Banana 2 API 가격과 작업 동작 방식
0.5K 및 1K 가격
0.5K는 이미지 한 장당 3 토큰($0.060)입니다. 1K는 이미지 한 장당 3.3 토큰($0.066)입니다.
2K 및 4K 가격
2K는 이미지 한 장당 5 토큰($0.100)입니다. 4K는 이미지 한 장당 7.5 토큰($0.150)입니다.
비동기 결과
제출 시 반환되는 값은 최종 이미지가 아니라 <code>img_uuid</code>입니다. 작업 상세 엔드포인트를 폴링하거나 콜백 이벤트를 처리해 최종 결과를 받으십시오.
세 단계로 Nano Banana 2 연동하기
1
1. 생성 요청 제출
https://api.goenhance.ai/api/v1/images/generations에 JSON을 POST하고 인증 정보와 model, prompt, 그리고 선택적인 비율, 크기, 웹 검색, 추론, 콜백 필드를 함께 보냅니다. 2
2. img_uuid 보관
성공 응답에서
data.img_uuid를 읽어 애플리케이션 요청과 연결해 두십시오. 3
3. 폴링 또는 콜백 수신
GET /api/v1/jobs/detail을 폴링하거나 콜백 이벤트를 처리합니다. 엔드포인트가 HTTP 200을 반환하지 않으면 GoEnhance 문서 기준으로 콜백을 최대 세 번까지 재시도하며, 시도당 타임아웃은 3초입니다.프롬프트, 검수, 저장, 전달은 애플리케이션이 관리하면서 통제된 이미지 생성 워크플로를 구축합니다.
Nano Banana 2 API 활용 사례
에디토리얼 일러스트레이션
정형화된 기사 기획안을 사람이 검수하는 대기열용 이미지 후보로 변환합니다.
제품 스토리텔링
제품 설명에서 장면 콘셉트를 생성해 이후 브랜드 및 컴플라이언스 검토에 활용합니다.
캠페인 변형
프롬프트와 종횡비 변형을 만들면서 각 비동기 작업을 개별적으로 추적합니다.
현지화 워크플로
작업 처리 구조를 바꾸지 않고 현지화된 프롬프트로 지역별 비주얼 콘셉트를 만듭니다.
콘셉트 개발
실제 제작 에셋을 확정하기 전에 캐릭터, 소품, 배경, 아트 디렉션을 탐색합니다.
자동화된 크리에이티브 파이프라인
콜백을 검수, 승인, 저장, 후속 에셋 처리 서비스에 연결합니다.
가격, 파라미터, 비동기 전달, Google API와의 관계에 대한 실무적인 답변입니다.