도구별 실전 가이드 · 공식 정보 확인 2026-08-20

NanoBananaEditor AGPL-3.0 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Web, Self-hosted · 페이지 갱신: · 운영·편집 기준

참조 이미지와 마스크·자연어 수정으로 변형을 만들고 버전 분기를 보존하는 Gemini 이미지 API 기반 비파괴 웹 생성·편집기입니다.

참조 이미지와 마스크·자연어 수정으로 변형을 만들고 버전 분기를 보존하는 Gemini 이미지 API 기반 비파괴 웹 생성·편집기입니다. NanoBananaEditor의 첫 실전 과제는 “제품 사진에서 선택한 배경만 계절 풍경으로 교체해 버전 비교하기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “제품 PNG와 배경 영역 마스크·겨울 창가라는 수정 지시” 같은 입력으로 NanoBananaEditor의 핵심 기능을 시험하려는 사람
  • 마스크 밖 제품 픽셀이 유지되고 이전 버전으로 완전히 되돌아가는지 기준으로 NanoBananaEditor 결과를 직접 검수할 수 있는 경우
  • Web·Self-hosted 환경에서 AGPL-3.0 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • Gemini 이미지 API 기반 비파괴 웹 생성·편집기 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 브라우저에 둔 Gemini API 키와 업로드 이미지가 노출되거나 마스크 밖 요소까지 API가 재생성하는 문제.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

제품과 배경 마스크를 분리한다

제품 픽셀을 보호하는 겨울 창가 편집 범위가 생긴다.

참고 시작점: 제품은 고정하고 배경 영역만 겨울 창가로 교체할 수 있게 마스크를 확인해 줘.

  1. Nano Banana Editor에 제품 PNG와 권리 확인 정보를 등록한다.
  2. image mask를 배경에만 칠하고 제품 가장자리 안쪽을 보호한다.
  3. reference image와 원본 크기를 첫 version으로 저장한다.

Gemini 이미지 수정본을 만든다

마스크 안에서만 계절 배경이 바뀐 후보가 생성된다.

참고 시작점: 마스크 안을 차가운 겨울 창가로 바꾸고 제품의 색·형태·그림자는 유지해 줘.

  1. Gemini 2.5 Flash Images API에 마스크와 수정 지시를 보낸다.
  2. 첫 결과에서 제품 윤곽과 로고가 재생성됐는지 픽셀 단위로 비교한다.
  3. 마스크 밖 변화가 크면 범위를 줄여 새 revision을 만든다.

버전 복원과 키 보관을 검증한다

원본으로 되돌릴 수 있는 승인 편집본이 남는다.

참고 시작점: 최종 후보와 원본의 마스크 밖 차이를 표시하고 이전 버전 복원을 시험해 줘.

  1. version history에서 원본과 각 후보를 순서대로 전환한다.
  2. 이전 버전 복원이 원본 PNG 해시와 일치하는지 확인한다.
  3. 브라우저 저장소의 Gemini API key와 업로드 기록을 정리한다.

무료 조건과 주의점

AGPL-3.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요

AGPL-3.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요

AGPL-3.0 라이선스의 고지·소스 공개·동일 라이선스 등 조건을 확인해야 합니다.

브라우저에 둔 Gemini API 키와 업로드 이미지가 노출되거나 마스크 밖 요소까지 API가 재생성하는 문제.

직접 대안과 비교

  • nova-image-studio — 참조 이미지와 이미지 편집 모델을 사용해 배경을 변경하고 작업 결과를 관리하므로, 같은 제품 PNG의 계절 배경 변형을 자가 호스팅 작업대에서 수행한다.

공식 근거와 확인일

NanoBananaEditor 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보참조 이미지와 마스크·자연어 수정으로 변형을 만들고 버전 분기를 보존하는 Gemini 이미지 API 기반 비파괴 웹 생성·편집기입니다.NanoBananaEditor 공식 사이트
무료 조건AGPL-3.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 핵심 기능에 외부 AI 공급자 계정 또는 API 키 필요공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지참조 이미지와 마스크·자연어 수정으로 변형을 만들고 버전 분기를 보존하는 Gemini 이미지 API 기반 비파괴 웹 생성·편집기입니다.공식 제품 페이지