> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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)"`<br />`"Nano Banana 2 Lite"` |
| `프롬프트`        | 생성할 이미지 또는 적용할 편집 내용을 설명하는 텍스트 프롬프트입니다. 모델이 따라야 하는 제약 조건, 스타일 또는 세부 사항을 포함하세요. 비어 있으면 안 됩니다. (기본값: 비어 있음)                                                                             | STRING         | 예   | N/A                                                                    |
| `시드`          | 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 모델이나 temperature와 같은 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. (기본값: 42) | INT            | 예   | 0 \~ 18446744073709551615                                              |
| `응답 모달리티`     | 응답 형식을 결정합니다. IMAGE는 이미지만 반환하고, IMAGE+TEXT는 이미지와 텍스트 응답을 반환합니다. (기본값: IMAGE) 고급 매개변수입니다.                                                                                              | COMBO          | 예   | `"IMAGE"`<br />`"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"`<br />`"1:1"`<br />`"2:3"`<br />`"3:2"`<br />`"3:4"`<br />`"4:3"`<br />`"4:5"`<br />`"5:4"`<br />`"9:16"`<br />`"16:9"`<br />`"21:9"`<br />`"1:4"`<br />`"4:1"`<br />`"8:1"`<br />`"1:8"` |
| `resolution`     | 대상 출력 해상도입니다.                                                                        | COMBO  | 예  | `"1K"`<br />`"2K"`<br />`"4K"`                                                                                                                                                                    |
| `thinking_level` | 모델이 사용하는 사고 수준을 선택합니다.                                                               | COMBO  | 예  | `"MINIMAL"`<br />`"HIGH"`                                                                                                                                                                         |

### Nano Banana 2 Lite 입력

| 매개변수             | 설명                                                                                   | 데이터 타입 | 필수 | 범위                                                                                                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------ | ------ | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `aspect_ratio`   | 'auto'로 설정하면 입력 이미지의 종횡비에 맞춰지며, 이미지가 제공되지 않으면 일반적으로 16:9 비율의 이미지가 생성됩니다. (기본값: auto) | COMBO  | 예  | `"auto"`<br />`"1:1"`<br />`"2:3"`<br />`"3:2"`<br />`"3:4"`<br />`"4:3"`<br />`"4:5"`<br />`"5:4"`<br />`"9:16"`<br />`"16:9"`<br />`"21:9"`<br />`"1:4"`<br />`"4:1"`<br />`"8:1"`<br />`"1:8"` |
| `resolution`     | 대상 출력 해상도입니다.                                                                        | COMBO  | 예  | `"1K"`                                                                                                                                                                                            |
| `thinking_level` | 모델이 사용하는 사고 수준을 선택합니다.                                                               | COMBO  | 예  | `"MINIMAL"`<br />`"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에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ko.md)

***

**Source fingerprint (SHA-256):** `347d28aeb46aa91f7515a31c385a3e3f805a1861116a21dd2ef6575ab7fd4f3e`
