> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# GeminiImage2Node - ComfyUI Built-in Node Documentation

> Complete documentation for the GeminiImage2Node node in ComfyUI. Learn its inputs, outputs, parameters and usage.

# GeminiImage2Node

GeminiImage2Node는 Google의 Vertex AI Gemini 모델을 사용하여 이미지를 생성하거나 편집합니다. 텍스트 프롬프트와 선택적 참조 이미지 또는 파일을 API로 전송하고 생성된 이미지 및/또는 텍스트 설명을 반환합니다.

## 입력

| 매개변수       | 설명                                                                                                                         | 데이터 타입 | 필수  | 범위                                                                                                                                            |
| ---------- | -------------------------------------------------------------------------------------------------------------------------- | ------ | --- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `프롬프트`     | 생성할 이미지 또는 적용할 편집 내용을 설명하는 텍스트 프롬프트입니다. 모델이 따라야 할 제약 조건, 스타일 또는 세부 사항을 포함하세요.                                              | STRING | 예   | 해당 없음                                                                                                                                         |
| `모델`       | 생성에 사용할 특정 Gemini 모델입니다. "Nano Banana 2" 옵션은 내부적으로 `gemini-3.1-flash-image-preview` 모델에 매핑됩니다.                             | COMBO  | 예   | `"gemini-3-pro-image-preview"`<br />`"Nano Banana 2 (Gemini 3.1 Flash Image)"`                                                                |
| `시드`       | 특정 값으로 고정하면 모델이 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 모델이나 다른 설정을 변경하면 동일한 시드라도 변형이 발생할 수 있습니다. 기본값: 42. | INT    | 예   | 0 \~ 18446744073709551615                                                                                                                     |
| `종횡비`      | 출력 이미지의 원하는 종횡비입니다. '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"` |
| `해상도`      | 대상 출력 해상도입니다. 2K/4K의 경우 기본 Gemini 업스케일러가 사용됩니다.                                                                            | COMBO  | 예   | `"1K"`<br />`"2K"`<br />`"4K"`                                                                                                                |
| `응답 형식`    | 이미지만 출력하려면 'IMAGE'를 선택하고, 생성된 이미지와 텍스트 응답을 모두 반환하려면 'IMAGE+TEXT'를 선택하세요.                                                   | COMBO  | 예   | `"IMAGE+TEXT"`<br />`"IMAGE"`                                                                                                                 |
| `이미지`      | 선택적 참조 이미지입니다. 여러 이미지를 포함하려면 배치 이미지 노드를 사용하세요(최대 14개).                                                                     | IMAGE  | 아니요 | 해당 없음                                                                                                                                         |
| `파일`       | 모델의 컨텍스트로 사용할 선택적 파일입니다. Gemini Generate Content Input Files 노드의 입력을 허용합니다.                                                | CUSTOM | 아니요 | 해당 없음                                                                                                                                         |
| `시스템 프롬프트` | AI의 동작을 지시하는 기본 지침입니다. 기본값: 이미지 생성을 위한 사전 정의된 시스템 프롬프트입니다.                                                                 | STRING | 아니요 | 해당 없음                                                                                                                                         |

**제약 조건:**

* `images` 입력은 최대 14개의 이미지를 지원합니다. 더 많이 제공하면 오류가 발생합니다.
* `files` 입력은 `GEMINI_INPUT_FILES` 데이터 타입을 출력하는 노드에 연결되어야 합니다.

## 출력

| 출력 이름    | 설명                                                     | 데이터 타입 |
| -------- | ------------------------------------------------------ | ------ |
| `image`  | Gemini 모델이 생성하거나 편집한 이미지입니다.                           | IMAGE  |
| `string` | 모델의 텍스트 응답입니다. `응답 형식`가 "IMAGE"로 설정된 경우 이 출력은 비어 있습니다. | STRING |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiImage2Node/ko.md)

***

**Source fingerprint (SHA-256):** `20a937a635f883a42e22582ae415f6d2a9a6ecc50f147c9090431877e5461144`
