개요
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 모델
네 개의 핵심 노드
이 플러그인은 서로 다른 사용 사례를 다루는 4개의 기능 노드를 제공합니다:시작하기: 설치 및 설정
1
1단계: 사전 요구 사항 확인
다음 항목이 설치되어 있는지 확인하십시오:
- ComfyUI (최신 버전) — 설치되어 있지 않다면 다음을 참조하십시오:
github.com/comfyanonymous/ComfyUI - Python 3.12+
- Git
2
2단계: 노드 코드 다운로드
터미널을 열고 ComfyUI의 커스텀 노드 디렉터리로 이동한 다음 저장소를 복제합니다:
3
3단계: 의존성 설치
플러그인 디렉터리로 들어가 필요한 의존성을 설치합니다:Nano Banana 2 노드 지원을 위해 다음도 설치하십시오:
4
4단계: APIYI 키 받기
- 가입/로그인을 위해 APIYI 콘솔을 방문하십시오.
- Token 섹션으로 이동하십시오.
- 새 API 키를 생성하십시오.
- 키를 복사하십시오(
sk-로 시작합니다).
새 사용자는 무료 체험 크레딧을 받으며, Nano Banana 이미지 생성을 체험하기에 충분합니다.
5
5단계: 환경 변수 설정
플러그인 디렉터리에서 템플릿 파일을 복사하고 자격 증명을 입력하십시오:APIYI 키와 기본 URL에 맞게
.env 파일을 편집하십시오: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: 이미지 편집 및 융합
참조 이미지를 사용해 생성을 유도합니다 — 스타일 전환, 요소 융합 등에 매우 유용합니다.- 참조 이미지를 Nano Banana AIO 노드의
image_1부터image_6까지 입력에 연결합니다 - 원하는 효과를
prompt에 설명합니다. 예: “이 사진을 수채화 스타일로 변환합니다” - 모델은 참조 이미지와 텍스트 설명을 결합하여 새 이미지를 생성합니다
시나리오 3: 다중 턴 대화형 편집
가장 독특한 기능입니다 — 채팅하듯 이미지를 단계별로 다듬을 수 있습니다.- Nano Banana Multi-Turn Chat 노드를 추가합니다
- 1라운드: 초기 설명을 입력하고 기본 이미지를 생성합니다
- 2라운드: 수정 내용을 입력합니다. 예: “배경을 해변으로 바꿔주세요”
- 3라운드: 계속 다듬습니다. 예: “일몰 조명을 추가하세요”
- 각 라운드는 대화 메모리를 바탕으로 이어집니다
reset_chat를 전환합니다.
노드 매개변수 참조
Nano Banana AIO / Nano Banana 2 AIO
지원되는 종횡비
자주 묻는 질문
설치 후 노드를 찾을 수 없습니까?
설치 후 노드를 찾을 수 없습니까?
다음을 확인하십시오:
- 플러그인 폴더가
ComfyUI/custom_nodes/디렉터리에 있습니다 pip3 install -r requirements.txt를 실행했습니다- Nano Banana 2 노드의 경우
pip install google-genai --upgrade도 실행하십시오 - ComfyUI를 재시작했습니다(브라우저만 새로고침한 것이 아니라 백엔드를 재시작해야 합니다)
API Key가 유효하지 않다는 오류가 발생합니까?
API Key가 유효하지 않다는 오류가 발생합니까?
다음을 확인하십시오:
GOOGLE_API_KEY파일의.env가 APIYI Key인지 확인하십시오(sk-로 시작합니다)CUSTOM_BASE_URL가https://api.apiyi.com로 설정되어 있습니다- APIYI 계정에 충분한 잔액이 있는지 확인하십시오(콘솔에서 확인)
생성이 느리거나 타임아웃이 발생합니까?
생성이 느리거나 타임아웃이 발생합니까?
- 4K 해상도는 더 오래 걸립니다 — 테스트용으로 먼저 1K를 시도하십시오
- 여러 이미지(image_count가 1보다 큼)는 처리 시간을 늘립니다
- 타임아웃이 자주 발생하면 더 낮은 해상도나 더 적은 이미지를 시도하십시오
Nano Banana Pro와 Nano Banana 2 중 무엇을 선택해야 합니까?
Nano Banana Pro와 Nano Banana 2 중 무엇을 선택해야 합니까?
- Nano Banana Pro (
gemini-3-pro-image-preview): 더 세밀한 품질로, 고급 제작에 적합합니다 - Nano Banana 2 (
gemini-3.1-flash-image-preview): 더 빠르고, 더 저렴하며($0.025/image부터), 더 많은 참조 이미지와 극단적인 비율을 지원합니다 - 일상적인 제작에는 Nano Banana 2를 권장하며, 최고의 품질이 필요하면 Pro를 선택하십시오
APIYI API key는 어떻게 받습니까?
APIYI API key는 어떻게 받습니까?
APIYI 콘솔에 접속하여 계정을 등록한 다음 Token 섹션에서 새 Key를 생성하십시오. 신규 사용자는 무료 체험 크레딧을 받습니다.
콘텐츠 안전성 때문에 이미지 생성에 실패했습니까?
콘텐츠 안전성 때문에 이미지 생성에 실패했습니까?
Nano Banana 모델에는 내장된 콘텐츠 안전성 검사가 있습니다. 일부 설명은 제한을 유발할 수 있습니다. 제안:
- prompt를 민감한 콘텐츠를 피하도록 조정하십시오
- 자세한 내용은 Nano Banana Image Failure Troubleshooting를 참조하십시오
관련 자료
Nano Banana Pro 문서
Nano Banana Pro 전체 API 문서 및 가격 정보 보기
Nano Banana 2 문서
Nano Banana 2 전체 API 문서 및 가격 정보 보기
이미지 실패 문제 해결
Nano Banana 이미지 생성 문제 해결 가이드
APIYI - Token 관리
API 키를 관리하고 사용량과 잔액을 확인합니다