Nano Banana 2 Edit API
GoEnhance를 통해 참조 이미지 기반 이미지 편집을 연동합니다. 원본 이미지 1~9장을 프롬프트와 함께 보내고 출력 크기와 비율을 선택한 뒤, 폴링 또는 HTTPS 콜백으로 결과를 받습니다. GoEnhance는 독립적인 API 액세스를 제공하며, Google의 공식 Gemini API가 아닙니다.
API 키 만들기
개발 워크플로를 위한 참조 이미지 기반 편집
편집 요청을 보내기 전에 실제 요청 규격을 확인합니다.
Nano Banana 2 Edit API 파라미터
엔드포인트
<code>https://api.goenhance.ai/api/v1/nano-banana-2/edit</code>로 POST 요청을 보냅니다.
인증
GoEnhance API 자격 증명을 <code>Authorization</code> 헤더에 포함합니다.
프롬프트
1자 이상 2000자 이하의 편집 지시문을 필수로 입력합니다.
이미지 목록
접근 가능한 URL을 가진 이미지 객체 1–9개로 이루어진 배열을 필수로 전달합니다.
비율
<code>auto</code>를 선택하거나, <code>1:1</code>부터 <code>21:9</code>, <code>4:1</code>, <code>8:1</code> 같은 와이드 형식까지 문서에 명시된 비율을 선택합니다.
출력 옵션
<code>0.5k</code>, <code>1k</code>, <code>2k</code>, <code>4k</code> 중에서 선택하고, 필요하면 <code>web_search</code>, <code>thinking_level</code>과 공개 HTTPS 콜백 URL을 설정합니다.
가격은 생성된 이미지 단위로 책정되며 요청한 출력 크기에 따라 달라집니다.
Nano Banana 2 Edit API 가격
0.5K와 1K
<code>0.5k</code>는 이미지당 3 tokens($0.060), <code>1k</code>는 이미지당 3.3 tokens($0.066)입니다.
2K와 4K
<code>2k</code>는 이미지당 5 tokens($0.100), <code>4k</code>는 이미지당 7.5 tokens($0.150)입니다.
비동기 응답
요청 시 반환되는 값은 최종 이미지가 아니라 <code>img_uuid</code>입니다. 최종 결과는 폴링이나 콜백으로 가져옵니다.
세 단계로 끝내는 Nano Banana 2 Edit 연동
1
1. 편집 준비
원본 이미지 1~9장을 접근 가능한 URL에 올리고, 정확한 프롬프트를 작성하고, 비율과 이미지 크기를 선택한 뒤 필요하면 콜백을 설정합니다.
2
2. 요청 전송과 ID 저장
인증 정보를 담아 JSON 페이로드를 POST하고 응답을 검증한 다음, 반환된
img_uuid를 애플리케이션의 작업 정보와 함께 저장합니다. 3
3. 결과 확인
작업이 성공하거나 실패할 때까지 작업 상세 엔드포인트를 폴링하거나 콜백 이벤트를 검증한 뒤, 결과물을 저장하거나 실패를 안전하게 표시합니다.
명확한 원본 에셋과 프롬프트를 중심으로 이미지 편집 기능을 만듭니다.
Nano Banana 2 Edit API 활용 사례
제품 장면 교체
전달한 제품 이미지를 원본 맥락을 유지한 채 새로운 배경에 배치합니다.
캠페인 변형
시즌별, 채널별 캠페인을 위한 프롬프트 기반 크리에이티브 변형을 생성합니다.
다중 참조 합성
편집에 여러 시각 참조가 필요한 경우 원본 이미지를 여러 장 사용합니다.
이커머스 제작
카탈로그 워크플로 전반에서 배경, 스타일링, 연출 편집을 자동화합니다.
현지화 크리에이티브
승인된 에셋을 바탕으로 지역별 캠페인에 맞게 장면 연출과 시각적 맥락을 조정합니다.
크리에이티브 프로토타이핑
프로덕션에 투입하기 전에 기존 참조 이미지로 새로운 아트 디렉션을 시험합니다.
가격, 입력, 비동기 전달, Google API 관련 여부에 대한 답변입니다.