> ## 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.

# OpenAIGPTImageNodeV3 - ComfyUI Built-in Node Documentation

> OpenAI GPT Image 2.6은 OpenAI의 GPT Image 모델을 사용하여 프롬프트로부터 이미지를 생성하고, 참조 이미지를 연결하면 해당 이미지를 편집합니다.

## 개요

OpenAI GPT Image 2.6은 OpenAI의 GPT Image 모델을 사용하여 프롬프트로부터 이미지를 생성하고, 참조 이미지를 연결하면 해당 이미지를 편집합니다. 이 노드는 `gpt-image-2.6-flare`, `gpt-image-2.6-sunburst`, `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`의 네 가지 모델을 제공합니다. 첫 번째 참조 이미지 위에 주석을 그리고 마크업 쌍으로 연결하여 모델이 편집할 위치를 정확히 보여 주세요.

## 입력

### 공통 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `model` | 사용할 GPT Image 모델입니다. 모델을 선택하면 해당 모델의 매개변수가 표시됩니다. | DYNAMIC\_COMBO | 예 | `"gpt-image-2.6-flare"` `"gpt-image-2.6-sunburst"` `"gpt-image-2.5-flare"` `"gpt-image-2.5-sunburst"` |

### gpt-image-2.6-flare 및 gpt-image-2.6-sunburst 입력

이 입력은 `model`이 `gpt-image-2.6-flare` 또는 `gpt-image-2.6-sunburst`로 설정된 경우 표시됩니다. 두 모델은 동일한 매개변수를 공유합니다.

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `model.prompt` | 생성할 내용 또는 수행할 편집입니다. (기본값: `""`) | STRING | 예 | N/A |
| `model.size` | 이미지 크기입니다. 사용자 지정 너비와 높이를 사용하려면 "Custom"을 선택합니다. (기본값: `"auto"`) | COMBO | 예 | `"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"` |
| `model.custom_width` | `model.size`가 "Custom"인 경우에만 사용됩니다. 16의 배수여야 합니다. (기본값: `1024`) | INT | 아니요 | 480 \~ 3840 (단계: 16) |
| `model.custom_height` | `model.size`가 "Custom"인 경우에만 사용됩니다. 16의 배수여야 합니다. (기본값: `1024`) | INT | 아니요 | 480 \~ 3840 (단계: 16) |
| `model.background` | 배경이 포함된 이미지 또는 배경이 없는 이미지를 반환합니다. (기본값: `"auto"`) | COMBO | 예 | `"auto"` `"opaque"` `"transparent"` |
| `model.quality` | 이미지 품질입니다. 수준이 높을수록 비용이 더 많이 들고 시간이 더 오래 걸립니다. (기본값: `"low"`) | COMBO | 예 | `"low"` `"medium"` `"high"` `"xhigh"` `"max"` |
| `model.complexity` | 모델이 렌더링하기 전에 이미지를 얼마나 계획하는지를 나타냅니다. (기본값: `"high"`) | COMBO | 예 | `"low"` `"medium"` `"high"` |
| `model.images` | 편집을 위한 선택적 참조 이미지입니다. 최대 16개입니다. | AUTOGROW | 아니요 | 0 \~ 16 |
| `model.markup` | 첫 번째 참조 이미지 위에 그린 주석으로, 편집할 위치를 표시합니다. 해당 이미지의 크기와 일치해야 하며, `model.markup_alpha`와 함께 연결해야 합니다. | IMAGE | 아니요 | N/A |
| `model.markup_alpha` | 흰색 부분은 `model.markup`의 주석을 표시합니다. Painter 노드의 MASK 출력은 바로 사용할 수 있으며, Load Image 마스크는 먼저 Invert Mask를 적용해야 합니다. | MASK | 아니요 | N/A |
| `model.seed` | 노드의 재실행 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. (기본값: `42`) | INT | 예 | 0 \~ 2147483647 |

### gpt-image-2.5-flare 및 gpt-image-2.5-sunburst 입력

이 입력은 `model`이 `gpt-image-2.5-flare` 또는 `gpt-image-2.5-sunburst`로 설정된 경우 표시됩니다. `model.complexity`가 제공되지 않는다는 점을 제외하면 2.6 모델과 동일합니다.

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `model.prompt` | 생성할 내용 또는 수행할 편집입니다. (기본값: `""`) | STRING | 예 | N/A |
| `model.size` | 이미지 크기입니다. 사용자 지정 너비와 높이를 사용하려면 "Custom"을 선택합니다. (기본값: `"auto"`) | COMBO | 예 | `"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"` |
| `model.custom_width` | `model.size`가 "Custom"인 경우에만 사용됩니다. 16의 배수여야 합니다. (기본값: `1024`) | INT | 아니요 | 480 \~ 3840 (단계: 16) |
| `model.custom_height` | `model.size`가 "Custom"인 경우에만 사용됩니다. 16의 배수여야 합니다. (기본값: `1024`) | INT | 아니요 | 480 \~ 3840 (단계: 16) |
| `model.background` | 배경이 포함된 이미지 또는 배경이 없는 이미지를 반환합니다. (기본값: `"auto"`) | COMBO | 예 | `"auto"` `"opaque"` `"transparent"` |
| `model.quality` | 이미지 품질입니다. 수준이 높을수록 비용이 더 많이 들고 시간이 더 오래 걸립니다. (기본값: `"low"`) | COMBO | 예 | `"low"` `"medium"` `"high"` `"xhigh"` `"max"` |
| `model.images` | 편집을 위한 선택적 참조 이미지입니다. 최대 16개입니다. | AUTOGROW | 아니요 | 0 \~ 16 |
| `model.markup` | 첫 번째 참조 이미지 위에 그린 주석으로, 편집할 위치를 표시합니다. 해당 이미지의 크기와 일치해야 하며, `model.markup_alpha`와 함께 연결해야 합니다. | IMAGE | 아니요 | N/A |
| `model.markup_alpha` | 흰색 부분은 `model.markup`의 주석을 표시합니다. Painter 노드의 MASK 출력은 바로 사용할 수 있으며, Load Image 마스크는 먼저 Invert Mask를 적용해야 합니다. | MASK | 아니요 | N/A |
| `model.seed` | 노드의 재실행 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. (기본값: `42`) | INT | 예 | 0 \~ 2147483647 |

**매개변수 제약 및 제한 사항:**

* `model.size`가 "Custom"으로 설정된 경우 `model.custom_width`와 `model.custom_height`는 모두 16의 배수여야 하고, 가장 긴 변은 3840을 초과할 수 없으며, 가로세로 비율은 3:1을 초과할 수 없고, 총 픽셀 수는 655,360 \~ 8,294,400이어야 합니다.
* `model.markup`과 `model.markup_alpha`는 함께 연결해야 합니다. 마크업에는 하나 이상의 참조 이미지가 필요하며, 너비와 높이는 첫 번째 참조 이미지와 일치해야 합니다.
* `model.images`가 없으면 노드는 프롬프트만으로 이미지를 생성하고, 참조 이미지가 있으면 해당 이미지를 편집하고 결합합니다.
* 참조 이미지는 API로 전송되기 전에 축소됩니다.
* `model.complexity`는 `gpt-image-2.6-flare`와 `gpt-image-2.6-sunburst`에만 존재하며, 2.5 모델은 고정된 계획 깊이를 사용합니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
| - | - | - |
| `image` | 생성된 한 개 이상의 이미지입니다. 반환된 모든 이미지는 하나의 배치로 스택되며, 크기가 다른 경우 첫 번째 이미지에 맞게 크기가 조정됩니다. | IMAGE |

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

***

**Source fingerprint (SHA-256):** `33f5d91af56c215cc7f7c704f9b123fe1c35bf287012072b818b76b551c04667`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.