GeminiNanoBanana2V2 - ComfyUI Built-in Node Documentation

이 노드는 Gemini 이미지 모델을 통해 Google Vertex AI API에 텍스트 프롬프트를 전송하여 이미지를 생성하거나 편집합니다. 설명을 기반으로 새 이미지를 만들거나 선택적 참조 이미지를 사용하여 기존 이미지를 수정합니다.

이 노드는 Gemini 이미지 모델을 통해 Google Vertex AI API에 텍스트 프롬프트를 전송하여 이미지를 생성하거나 편집합니다. 설명을 기반으로 새 이미지를 만들거나 선택적 참조 이미지를 사용하여 기존 이미지를 수정합니다.

​

입력

​

공통 입력

매개변수	설명	데이터 타입	필수	범위
모델	사용할 Gemini 이미지 모델을 선택합니다. 선택한 모델에 따라 사용 가능한 해상도 옵션과 모델별 입력이 결정됩니다.	DYNAMIC_COMBO	예	"Nano Banana 2 (Gemini 3.1 Flash Image)" "Nano Banana 2 Lite"
프롬프트	생성할 이미지 또는 적용할 편집 내용을 설명하는 텍스트 프롬프트입니다. 모델이 따라야 하는 제약 조건, 스타일 또는 세부 사항을 포함하세요. 비어 있으면 안 됩니다. (기본값: 비어 있음)	STRING	예	N/A
시드	시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 모델이나 temperature와 같은 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. (기본값: 42)	INT	예	0 ~ 18446744073709551615
응답 모달리티	응답 형식을 결정합니다. IMAGE는 이미지만 반환하고, IMAGE+TEXT는 이미지와 텍스트 응답을 반환합니다. (기본값: IMAGE) 고급 매개변수입니다.	COMBO	예	"IMAGE" "IMAGE+TEXT"
시스템 프롬프트	AI의 동작을 결정하는 기본 지침입니다. 기본값은 모델이 항상 이미지를 생성하도록 지시하는 내장 프롬프트입니다. 고급 매개변수입니다.	STRING	아니오	N/A
temperature	생성 시 무작위성을 제어합니다. 값이 낮을수록 더 집중적이고 결정적입니다. (기본값: 1.0) 고급 매개변수입니다.	FLOAT	아니오	0.0 ~ 2.0 (step 0.01)
top_p	핵 샘플링 임계값입니다. 값이 낮을수록 더 집중적이고, 높을수록 더 다양해집니다. (기본값: 0.95) 고급 매개변수입니다.	FLOAT	아니오	0.0 ~ 1.0 (step 0.01)

​

Nano Banana 2 (Gemini 3.1 Flash Image) 입력

매개변수	설명	데이터 타입	필수	범위
aspect_ratio	’auto’로 설정하면 입력 이미지의 종횡비에 맞춰지며, 이미지가 제공되지 않으면 일반적으로 16:9 비율의 이미지가 생성됩니다. (기본값: auto)	COMBO	예	"auto" "1:1" "2:3" "3:2" "3:4" "4:3" "4:5" "5:4" "9:16" "16:9" "21:9" "1:4" "4:1" "8:1" "1:8"
resolution	대상 출력 해상도입니다.	COMBO	예	"1K" "2K" "4K"
thinking_level	모델이 사용하는 사고 수준을 선택합니다.	COMBO	예	"MINIMAL" "HIGH"

​

Nano Banana 2 Lite 입력

매개변수	설명	데이터 타입	필수	범위
aspect_ratio	’auto’로 설정하면 입력 이미지의 종횡비에 맞춰지며, 이미지가 제공되지 않으면 일반적으로 16:9 비율의 이미지가 생성됩니다. (기본값: auto)	COMBO	예	"auto" "1:1" "2:3" "3:2" "3:4" "4:3" "4:5" "5:4" "9:16" "16:9" "21:9" "1:4" "4:1" "8:1" "1:8"
resolution	대상 출력 해상도입니다.	COMBO	예	"1K"
thinking_level	모델이 사용하는 사고 수준을 선택합니다.	COMBO	예	"MINIMAL" "HIGH"

​

참조 입력

매개변수	설명	데이터 타입	필수	범위
images	선택적 참조 이미지입니다. 최대 총 14개 이미지까지 가능합니다. 확장 가능한 슬롯: image_1부터 image_14까지 연결합니다.	IMAGE	아니오	0 ~ 14 images
files	모델의 컨텍스트로 사용할 선택적 파일입니다. Gemini Generate Content Input Files 노드의 입력을 허용합니다.	GEMINI_INPUT_FILES	아니오	N/A

참고: images 입력에는 최대 14개의 참조 이미지를 연결할 수 있으며, 이 한도를 초과하면 오류가 발생합니다.

​

출력

출력 이름	설명	데이터 타입
IMAGE	생성되거나 편집된 이미지입니다.	IMAGE
STRING	모델이 생성한 텍스트 설명 또는 캡션입니다. response_modalities가 IMAGE로 설정된 경우처럼 텍스트가 반환되지 않으면 비어 있습니다.	STRING
사고 이미지	모델의 사고 과정에서 나온 첫 번째 이미지입니다. thinking_level이 HIGH이고 IMAGE+TEXT 모드인 경우에만 사용할 수 있습니다.	IMAGE

참고: response_modalities가 IMAGE로 설정된 경우 STRING 출력은 비어 있습니다. 이 모드에서 모델이 이미지를 생성하지 않으면 노드는 모델의 추론을 확인하기 위해 IMAGE+TEXT로 전환할 것을 제안하는 오류를 발생시킵니다.

이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! GitHub에서 편집

---

Source fingerprint (SHA-256): 347d28aeb46aa91f7515a31c385a3e3f805a1861116a21dd2ef6575ab7fd4f3e