Nano Banana Pro Edit API
프롬프트 기반 이미지 편집을 GoEnhance를 통해 연동합니다. 소스 이미지 1~9장을 전송하고 지원되는 비율과 출력 크기를 선택한 뒤, 폴링 또는 HTTPS 콜백으로 결과를 받습니다. GoEnhance는 독립적인 서드파티 API 접근을 제공하며, Google의 공식 Gemini API가 아닙니다.
API 키 만들기
개발 워크플로를 위한 참조 이미지 기반 편집
편집을 전송하기 전에 실제 요청 규격을 확인하십시오.
Nano Banana Pro Edit API 파라미터
엔드포인트
<code>https://api.goenhance.ai/api/v1/images/generations</code>로 POST 요청을 보냅니다.
모델
필수 항목인 <code>model</code> 값을 <code>nano-banana-pro-edit</code>로 설정합니다.
프롬프트
1자 이상 2000자 이하의 이미지 편집 지시문을 필수로 입력합니다.
이미지 목록
공개적으로 접근 가능한 URL을 가진 이미지 객체 1~9개를 필수 배열로 전달합니다.
비율
<code>auto</code>를 선택하거나, 정사각형과 세로형부터 <code>21:9</code>까지 문서에 명시된 비율 중에서 선택합니다.
출력 제어
<code>1k</code>, <code>2k</code>, <code>4k</code> 중에서 선택합니다. 필요하면 <code>web_search</code>를 켜고 공개 HTTPS 콜백 URL을 설정할 수 있습니다.
GoEnhance는 생성 이미지 한 장당 해상도 기준 요금을 명시하고 있습니다.
Nano Banana Pro Edit API 요금
1K 출력
<code>1k</code> 이미지는 장당 7토큰, 즉 장당 $0.140입니다.
2K 및 4K 출력
<code>2k</code> 이미지는 장당 7토큰($0.140), <code>4k</code> 이미지는 장당 12토큰($0.240)입니다.
비동기 응답
전송 시 반환되는 값은 최종 이미지가 아니라 <code>img_uuid</code>입니다. 최종 결과는 폴링이나 콜백으로 확인합니다.
세 단계로 Nano Banana Pro Edit 연동하기
1
1. 편집 준비
소스 이미지 1~9장을 접근 가능한 URL에 올리고, 정확한 프롬프트를 작성하고, 비율과 출력 크기를 고른 뒤 필요하면 콜백을 설정합니다.
2
2. 전송 후 ID 저장
인증된 JSON 페이로드를 POST하고 응답을 검증한 다음, 반환된
img_uuid를 애플리케이션 작업과 함께 저장합니다. 3
3. 최종 결과 확인
작업 상세 엔드포인트를 폴링하거나 콜백 이벤트를 검증해 작업이 성공 또는 실패로 확정될 때까지 기다린 뒤, 결과물을 저장하거나 실패를 처리합니다.
명확한 소스 자산과 프롬프트를 중심으로 이미지 편집 기능을 구축합니다.
Nano Banana Pro Edit API 활용 사례
제품 장면 교체
승인된 제품 이미지를 원본의 유용한 맥락은 유지한 채 새로운 시각적 배경에 배치합니다.
캠페인 변형 제작
시즌 캠페인과 채널별 크리에이티브를 위해 프롬프트로 지시한 대안을 만듭니다.
다중 참조 이미지 합성
편집이 승인된 여러 시각 자료에 의존할 때 여러 장의 소스 이미지를 사용합니다.
이커머스 대량 제작
카탈로그 워크플로 전반에서 배경, 스타일링, 연출 편집을 자동화합니다.
현지화된 크리에이티브
기존 자산을 바탕으로 지역 캠페인에 맞게 장면 연출과 시각적 맥락을 조정합니다.
크리에이티브 프로토타이핑
프로덕션 자산을 확정하기 전에 제공된 참조 이미지로 아트 디렉션을 탐색합니다.
요금, 참조 이미지, 비동기 결과 수신, Google API와의 관계에 대한 답변입니다.