Skip to main content

​
개요

api_yi_nano_banana_node은 커뮤니티 파트너 JerrIsTheBesta가 기여한 가벼운 ComfyUI 커스텀 노드입니다. 이 노드는 “바로 넣어 쓸 수 있는 간편함 + 쉬운 확장성”에 중점을 둡니다. custom_nodes 디렉터리에 그대로 넣고 ComfyUI를 다시 시작하면, 워크플로에서 APIYI의 Nano Banana Pro / Nano Banana 2 이미지 생성을 직접 호출할 수 있습니다. 학습과 커스터마이징을 시작하기에 안성맞춤인 출발점입니다.
프로젝트 정보
  • 🔗 출처: github.com/JerrIsTheBesta/api_yi_nano_banana_node
  • 📜 라이선스: MIT
  • 👤 작성자: JerrIsTheBesta
  • ⭐ 커뮤니티 파트너가 기여한 항목이며 — 확장할 수 있는 예제로 배치됨
대상은 누구입니까?이 노드는 가장 흔한 두 가지 작업, 즉 텍스트-투-이미지와 다중 이미지 편집에 중점을 둡니다. 코드는 최소한으로 구성되어 있으며 읽기 쉽습니다. 더 풍부한 기능(대화형 편집, 14장 이미지 블렌딩 등)이 필요하다면 기능이 더 풍부한 Nano Banana ComfyUI 노드를 확인하시거나, 이 노드를 포크해서 확장하십시오.

​
핵심 기능

두 개의 핵심 노드

APIYI Text to Image + APIYI Multi Image Edit — 가장 일반적인 두 가지 워크플로를 포괄합니다

듀얼 모델 전환

gemini-3-pro-image-preview (Nano Banana Pro)와 gemini-3.1-flash-image-preview 중에서 선택할 수 있습니다

고해상도 출력

해상도에 따라 자동 타임아웃 조정을 적용하여 2K / 4K 출력을 지원합니다

다양한 화면 비율

기본 제공 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4, 4:5 — 총 10가지 비율

다중 이미지 편집

Multi Image Edit은 최대 5개의 참조 이미지를 받아 블렌딩 / 스타일 전이에 사용합니다

경량이며 수정하기 쉬움

최소한의 의존성(requests / Pillow / numpy)만 사용하는 순수 Python입니다. 구조가 깔끔하고 커스터마이즈하기 쉽습니다

​
지원되는 APIYI 모델

​
Node Details

​
APIYI 텍스트를 이미지로

텍스트 prompt에서 이미지를 생성합니다 — 입력 이미지가 필요하지 않습니다. 출력: 생성된 이미지 + 파일명 식별자.

​
APIYI 다중 이미지 편집

혼합, 편집 또는 구성을 위해 최대 5개의 입력 이미지를 받습니다. 출력: 결과 이미지, 파일명, 실제로 사용된 이미지 수.

​
Node Parameters

​
설치

1

1단계: custom_nodes에 넣기

ComfyUI 설치 디렉터리에서 custom_nodes 아래에 저장소를 클론합니다:
2

2단계: Python 의존성 설치

의존성은 최소입니다. ComfyUI에는 일반적으로 torch가 함께 제공됩니다. 누락된 항목만 설치합니다:
3

3단계: ComfyUI 재시작

재시작 후 노드 팔레트에서 APIYI를 검색하여 다음 항목을 찾습니다:
  • APIYI Text to Image
  • APIYI Multi Image Edit
4

4단계: APIYI 키 구성

  • APIYI 콘솔 → Tokens로 이동한 다음, 사용량 한도가 있는 전용 키를 생성합니다(보안 모범 사례)
  • 키를 노드의 api_key 필드에 붙여넣습니다
  • 별도의 엔드포인트 설정은 필요하지 않습니다 — 노드는 내부적으로 https://api.apiyi.com를 사용합니다
5

5단계: 간단한 워크플로 만들기

  • 텍스트-투-이미지: APIYI Text to Image → Preview Image
  • 다중 이미지 편집: 여러 Load Image → APIYI Multi Image Edit → Preview Image

​
사용 예시

​
예시 1: 텍스트를 이미지로 변환

​
예시 2: 다중 이미지 블렌딩

​
확장 아이디어

이 프로젝트는 예시이자 시작점으로 자리 잡고 있습니다. 필요에 따라 포크하여 확장하십시오:

대화형 편집

반복적인 다듬기를 위해 노드 내부에 세션 컨텍스트를 유지합니다

참조 이미지 추가

Nano Banana Pro의 전체 용량에 맞추기 위해 제한을 14개 이미지로 늘립니다

시드 제어

재현 가능한 생성을 위해 seed 매개변수를 추가합니다

배치 출력

이미지 배치를 하위 ComfyUI 노드로 내보냅니다

​
자주 묻는 질문

  1. 저장소가 ComfyUI/custom_nodes/ 안에 있는지 확인하십시오
  2. ComfyUI를 완전히 다시 시작하십시오(프런트엔드만 새로 고침하지 마십시오)
  3. ComfyUI의 콘솔에서 Python import 오류가 있는지 확인하십시오
확인하십시오:
  1. api_key이 올바르고 잘못된 채널로 제한되지 않았는지
  2. 선택한 모델이 token의 허용 목록에 있는지
  3. 계정 잔액이 충분한지 — 잔액은 충분해 보이지만 호출이 실패합니다를 참조하십시오
이 노드는 4K에 대해 시간 초과를 자동으로 연장하지만, 여전히 실패하면:
  1. API로 가는 네트워크 경로를 확인하십시오(CDN 이미지/동영상 다운로드가 느립니다 참조)
  2. 피크 시간에는 2K 또는 Flash로 전환하십시오
작성자는 master key를 사용하지 말 것을 명시적으로 권장합니다 — 이 노드용으로 APIYI 콘솔에서 사용 한도가 있는 전용 token을 만들어, 유출 시 피해 범위가 제한되도록 하십시오.
  • 이 노드: 가벼운 예제, 노드 2개만 포함, 의존성이 최소입니다 — 온보딩과 커스터마이징에 이상적입니다
  • 전체 버전: 더 풍부한 기능 세트(대화형 편집, 14개 이미지 블렌딩), 프로덕션 워크플로용으로 설계되었습니다

​
관련 리소스

Nano Banana Pro API

Nano Banana Pro의 전체 API 레퍼런스

전체 ComfyUI 노드

기능이 모두 갖춰진 Nano Banana ComfyUI 노드 팩

시나리오 개요

더 많은 APIYI 시나리오를 둘러보십시오

APIYI 콘솔

API 키와 사용량을 관리합니다