메인 콘텐츠로 건너뛰기

​
개요

ComfyUI-Nano-Banana-apiyi는 APIYI 사용자를 위해 특별히 제작된, 커뮤니티가 기여한 ComfyUI 커스텀 노드 모음입니다. 이를 통해 Google의 가장 강력한 이미지 생성 모델인 Nano Banana Pro와 Nano Banana 2를 Google Cloud 계정 없이 ComfyUI 워크플로 안에서 직접 호출할 수 있습니다. 시작하려면 APIYI API key만 있으면 됩니다.
프로젝트 정보
  • 🔗 소스 코드: github.com/pdmaker/ComfyUI-Nano-Banana-apiyi
  • 📜 라이선스: MIT
  • 👤 저자: 커뮤니티 기여(원래 저장소는 삭제되었으며, 현재는 백업 미러를 사용 중입니다)
  • ⭐ 커뮤니티 기여, APIYI에 맞게 조정됨

​
이 노드를 선택해야 하는 이유

진입 장벽 없음

Google Cloud 계정이 필요하지 않습니다 — APIYI 키로 Nano Banana Pro 및 Nano Banana 2 모델에 액세스할 수 있습니다

멀티모달 생성

모든 창작 요구에 맞는 텍스트-투-이미지, 이미지-투-이미지, 멀티 이미지 융합(최대 14개의 참고 이미지)을 지원합니다

멀티턴 채팅 편집

반복적 개선을 위한 컨텍스트 메모리를 갖춘 독특한 대화형 이미지 생성입니다

초고해상도

14개의 화면 비율로 512px, 1K, 2K, 4K 출력을 지원하며 포스터, 월페이퍼, 소셜 미디어 등 다양한 용도를 포괄합니다

​
지원되는 APIYI 모델

어떤 모델을 선택해야 합니까? 최고 품질을 원한다면 Nano Banana Pro를 선택하고, 가격 대비 성능을 원한다면 Nano Banana 2를 선택하십시오(이미지당 최저 $0.025). 두 모델 모두 동일한 ComfyUI 워크플로에서 사용할 수 있습니다.

​
네 개의 핵심 노드

이 플러그인은 서로 다른 사용 사례를 다루는 4개의 기능 노드를 제공합니다:

​
시작하기: 설치 및 설정

1

1단계: 사전 요구 사항 확인

다음 항목이 설치되어 있는지 확인하십시오:
  • ComfyUI (최신 버전) — 설치되어 있지 않다면 다음을 참조하십시오: github.com/comfyanonymous/ComfyUI
  • Python 3.12+
  • Git
Python 버전은 3.12 이상이어야 합니다. 더 낮은 버전에서는 의존성 설치에 실패할 수 있습니다.
2

2단계: 노드 코드 다운로드

터미널을 열고 ComfyUI의 커스텀 노드 디렉터리로 이동한 다음 저장소를 복제합니다:
3

3단계: 의존성 설치

플러그인 디렉터리로 들어가 필요한 의존성을 설치합니다:
Nano Banana 2 노드 지원을 위해 다음도 설치하십시오:
4

4단계: APIYI 키 받기

  1. 가입/로그인을 위해 APIYI 콘솔을 방문하십시오.
  2. Token 섹션으로 이동하십시오.
  3. 새 API 키를 생성하십시오.
  4. 키를 복사하십시오(sk-로 시작합니다).
새 사용자는 무료 체험 크레딧을 받으며, Nano Banana 이미지 생성을 체험하기에 충분합니다.
5

5단계: 환경 변수 설정

플러그인 디렉터리에서 템플릿 파일을 복사하고 자격 증명을 입력하십시오:
APIYI 키와 기본 URL에 맞게 .env 파일을 편집하십시오:
핵심 설정: CUSTOM_BASE_URL를 https://api.apiyi.com로 설정해야 합니다. 그래야 모든 요청이 APIYI를 통해 라우팅되며 Google Cloud 계정이 필요하지 않습니다. 코드는 올바른 API 버전 경로를 자동으로 덧붙입니다.
6

6단계: ComfyUI 재시작 및 확인

ComfyUI를 다시 시작한 후 노드 목록에서 Nano Banana를 검색하십시오. 다음 4개의 새 노드가 보여야 합니다:
  • Nano Banana AIO
  • Nano Banana Multi-Turn Chat
  • Nano Banana 2 AIO
  • Nano Banana 2 Multi-Turn Chat
이 노드들이 보이면 설치가 성공한 것입니다!

​
실습 튜토리얼: 텍스트에서 이미지로

​
시나리오 1: 텍스트-이미지 생성(기본)

가장 간단한 사용 방법입니다 — 텍스트 설명을 입력하면 이미지를 생성합니다.
1

노드 추가

ComfyUI 캔버스를 마우스 오른쪽 버튼으로 클릭하고, Nano Banana AIO 노드(또는 Nano Banana 2 AIO)를 검색하여 추가합니다.
2

프롬프트 작성

원하는 이미지 설명을 prompt 필드에 입력합니다. 예를 들면 다음과 같습니다.
3

매개변수 구성

  • image_count: 생성할 이미지 수입니다(1-10)
  • aspect_ratio: 비율을 선택합니다. 예: 16:9(가로형 배경화면) 또는 9:16(휴대폰 배경화면)
  • image_size: 해상도입니다 — 2K 또는 4K를 권장합니다
  • temperature: 창의성 수준입니다. 0.0은 가장 보수적이고, 2.0은 가장 창의적입니다
4

워크플로 실행

ComfyUI의 Queue Prompt 버튼을 클릭하고 몇 초만 기다리면 생성된 이미지를 볼 수 있습니다.

​
시나리오 2: 이미지 편집 및 융합

참조 이미지를 사용해 생성을 유도합니다 — 스타일 전환, 요소 융합 등에 매우 유용합니다.
  1. 참조 이미지를 Nano Banana AIO 노드의 image_1부터 image_6까지 입력에 연결합니다
  2. 원하는 효과를 prompt에 설명합니다. 예: “이 사진을 수채화 스타일로 변환합니다”
  3. 모델은 참조 이미지와 텍스트 설명을 결합하여 새 이미지를 생성합니다
Nano Banana 2 AIO 전용: 최대 14개의 참조 이미지(객체 10개 + 캐릭터 일관성 참조 4개)를 지원하며, 캐릭터 외형을 일관되게 유지해야 하는 창작 프로젝트에 이상적입니다.

​
시나리오 3: 다중 턴 대화형 편집

가장 독특한 기능입니다 — 채팅하듯 이미지를 단계별로 다듬을 수 있습니다.
  1. Nano Banana Multi-Turn Chat 노드를 추가합니다
  2. 1라운드: 초기 설명을 입력하고 기본 이미지를 생성합니다
  3. 2라운드: 수정 내용을 입력합니다. 예: “배경을 해변으로 바꿔주세요”
  4. 3라운드: 계속 다듬습니다. 예: “일몰 조명을 추가하세요”
  5. 각 라운드는 대화 메모리를 바탕으로 이어집니다
대화 기록을 지우고 새로 시작하려면 reset_chat를 전환합니다.

​
노드 매개변수 참조

​
Nano Banana AIO / Nano Banana 2 AIO

​
지원되는 종횡비

​
자주 묻는 질문

다음 항목을 확인하세요:
  1. 플러그인 폴더가 ComfyUI/custom_nodes/ 디렉터리에 있는지 확인하세요
  2. pip3 install -r requirements.txt을 실행했는지 확인하세요
  3. Nano Banana 2 노드의 경우 pip install google-genai --upgrade도 실행하세요
  4. ComfyUI를 다시 시작했는지 확인하세요(브라우저 새로고침만으로는 부족하며 백엔드를 다시 시작해야 합니다)
다음 항목을 확인하세요:
  1. .env 파일의 GOOGLE_API_KEY이 APIYI 키인지 확인하세요(sk-로 시작합니다)
  2. CUSTOM_BASE_URL이 https://api.apiyi.com으로 설정되어 있는지 확인하세요
  3. APIYI 계정의 잔액이 충분한지 확인하세요(콘솔에서 확인 가능)
  • 4K 해상도는 생성 시간이 더 오래 걸립니다. 테스트할 때는 먼저 1K를 사용해 보세요
  • 이미지 수(image_count가 1보다 큰 경우)가 늘어나면 처리 시간이 증가합니다
  • 시간 초과가 자주 발생하면 해상도를 낮추거나 이미지 수를 줄여 보세요
  • Nano Banana Pro (gemini-3-pro-image): 더 섬세한 품질로, 프리미엄 결과물을 만들기에 적합합니다
  • Nano Banana 2 (gemini-3.1-flash-image): 더 빠르고 저렴하며(이미지당 $0.025부터), 참조 이미지를 더 많이 사용할 수 있고 극단적인 화면 비율을 지원합니다
  • 일상적인 제작에는 Nano Banana 2를 권장하며, 최고의 품질을 원한다면 Pro를 선택하세요
APIYI 콘솔에 방문해 계정을 등록한 다음, Token 섹션에서 새 키를 생성하세요. 신규 사용자는 무료 체험 크레딧을 받습니다.
Nano Banana 모델에는 콘텐츠 안전성 검사가 내장되어 있습니다. 일부 설명은 제한을 유발할 수 있습니다. 다음을 참고하세요:
  1. 민감한 콘텐츠를 피하도록 prompt를 수정하세요
  2. 추가 지원이 필요하면 Nano Banana 이미지 생성 실패 문제 해결을 참조하세요

​
관련 자료

Nano Banana Pro 문서

Nano Banana Pro 전체 API 문서와 가격 보기

Nano Banana 2 문서

Nano Banana 2 전체 API 문서와 가격 보기

이미지 생성 실패 문제 해결

Nano Banana 이미지 생성 문제 해결 가이드

APIYI - Token 관리

API 키를 관리하고 사용량과 잔액을 확인합니다