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

# GeminiImage2Node - ComfyUI Built-in Node Documentation

> GeminiImage2Node는 Google Vertex AI Gemini 모델을 사용하여 이미지를 생성하거나 편집합니다. 텍스트 프롬프트와 선택적으로 참조 이미지나 파일을 제공하면, 노드가 이를 API로 전송하고 생성된 이미지와 요청 시 텍스트 응답을 반환합니다.

GeminiImage2Node는 Google Vertex AI Gemini 모델을 사용하여 이미지를 생성하거나 편집합니다. 텍스트 프롬프트와 선택적으로 참조 이미지나 파일을 제공하면, 노드가 이를 API로 전송하고 생성된 이미지와 요청 시 텍스트 응답을 반환합니다.

## 입력

| 매개변수       | 설명                                                                                                                                                                        | 데이터 타입               | 필수  | 범위                                                                                                                                            |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `프롬프트`     | 생성할 이미지나 적용할 편집 내용을 설명하는 텍스트 프롬프트입니다. 모델이 따라야 할 제약 조건, 스타일, 세부 사항을 포함하세요. 프롬프트는 공백을 제거한 후 최소 한 글자 이상이어야 합니다.                                                              | STRING               | 예   | 해당 없음                                                                                                                                         |
| `모델`       | 생성에 사용할 특정 Gemini 모델입니다. "Nano Banana 2 (Gemini 3.1 Flash Image)" 옵션은 내부적으로 `gemini-3.1-flash-image` 모델에 매핑되고, "gemini-3-pro-image-preview"는 `gemini-3-pro-image`에 매핑됩니다. | 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"`                                                                                                                 |
| `이미지`      | 선택적 참조 이미지입니다. 여러 이미지를 포함하려면 Batch Images 노드를 사용하세요(최대 14개).                                                                                                              | IMAGE                | 아니요 | 해당 없음                                                                                                                                         |
| `파일`       | 모델의 컨텍스트로 사용할 선택적 파일입니다. Gemini Generate Content Input Files 노드의 입력을 허용합니다.                                                                                               | GEMINI\_INPUT\_FILES | 아니요 | 해당 없음                                                                                                                                         |
| `시스템 프롬프트` | AI의 동작을 규정하는 기본 지침입니다. 기본값: 이미지 생성을 위해 사전 정의된 시스템 프롬프트.                                                                                                                   | STRING               | 아니요 | 해당 없음                                                                                                                                         |

**제약 사항:**

* `images` 입력은 최대 14개의 이미지를 지원합니다. 더 많이 제공하면 오류가 발생합니다.
* 10개를 초과하는 이미지를 제공하면 처음 10개는 URL 참조로 업로드되고 나머지 이미지는 요청에 인라인으로 전송됩니다.
* `files` 입력은 `GEMINI_INPUT_FILES` 데이터 타입을 출력하는 노드에 연결되어야 합니다.
* `response_modalities`가 "IMAGE"로 설정되면 이미지만 반환되고 텍스트 출력은 비어 있습니다.

## 출력

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

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

***

**Source fingerprint (SHA-256):** `02293dad786d4b441da3174fa76f6c5847f122d294bd7e1f765ffd72420034a4`
