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

# OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation

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

## 개요

이 노드는 OpenAI의 GPT 이미지 API를 사용하여 이미지를 생성합니다. 여러 모델을 지원하며, 편집을 위한 입력 이미지를 제공할 수 있고, 마스크를 사용하여 이미지의 특정 부분을 수정할 수 있습니다.

## 입력

| 매개변수                  | 설명                                                                                       | 데이터 타입 | 필수 여부 | 범위                                                                                                                                                                               |
| --------------------- | ---------------------------------------------------------------------------------------- | ------ | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `프롬프트`                | GPT 이미지용 텍스트 프롬프트 (기본값: "").                                                             | STRING | 예     | 해당 없음                                                                                                                                                                            |
| `모델`                  | 사용할 OpenAI GPT 이미지 모델입니다. 모델을 선택하면 해당 모델에 특화된 추가 매개변수가 표시됩니다.                            | COMBO  | 예     | `"gpt-image-2"`<br />`"gpt-image-1.5"`<br />`"gpt-image-1"`                                                                                                                      |
| `model.size`          | 이미지 크기입니다. 'Custom'을 선택하면 사용자 정의 너비와 높이를 사용합니다 (기본값: "auto"). `gpt-image-2`에서만 사용 가능합니다. | COMBO  | 예     | `"auto"`<br />`"1024x1024"`<br />`"1024x1536"`<br />`"1536x1024"`<br />`"2048x2048"`<br />`"2048x1152"`<br />`"1152x2048"`<br />`"3840x2160"`<br />`"2160x3840"`<br />`"Custom"` |
| `model.custom_width`  | `size`가 'Custom'일 때만 사용됩니다. 16의 배수여야 합니다 (기본값: 1024). `gpt-image-2`에서만 사용 가능합니다.         | INT    | 아니요   | 1024 \~ 3840                                                                                                                                                                     |
| `model.custom_height` | `size`가 'Custom'일 때만 사용됩니다. 16의 배수여야 합니다 (기본값: 1024). `gpt-image-2`에서만 사용 가능합니다.         | INT    | 아니요   | 1024 \~ 3840                                                                                                                                                                     |
| `model.background`    | 배경 유무에 따라 이미지를 반환합니다 (기본값: "auto"). `gpt-image-2`에서만 사용 가능합니다.                           | COMBO  | 예     | `"auto"`<br />`"opaque"`                                                                                                                                                         |
| `model.quality`       | 생성된 이미지의 품질입니다. `gpt-image-2`에서만 사용 가능합니다.                                               | COMBO  | 예     | `"standard"`<br />`"hd"`                                                                                                                                                         |
| `model.images`        | 편집을 위한 입력 이미지입니다. `gpt-image-2`에서만 사용 가능합니다.                                             | IMAGE  | 아니요   | 해당 없음                                                                                                                                                                            |
| `model.mask`          | 입력 이미지에서 편집할 부분을 지정하는 마스크입니다. `gpt-image-2`에서만 사용 가능합니다.                                 | MASK   | 아니요   | 해당 없음                                                                                                                                                                            |
| `개수`                  | 생성할 이미지 개수입니다 (기본값: 1).                                                                  | INT    | 예     | 1 \~ 8                                                                                                                                                                           |
| `시드`                  | 재현성을 위한 시드 값입니다 (기본값: 0). 참고: 현재 백엔드에서 구현되지 않았습니다.                                       | INT    | 예     | 0 \~ 2147483647                                                                                                                                                                  |

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

* `gpt-image-2`를 사용할 때 `model.size`가 "Custom"인 경우, `custom_width`와 `custom_height`는 16의 배수여야 하며, 최대 변의 길이는 3840 이하여야 하고, 종횡비는 3:1을 초과할 수 없으며, 총 픽셀 수는 655,360에서 8,294,400 사이여야 합니다.
* `mask`가 제공되면 입력 이미지(`model.images`)가 필수입니다. 입력 이미지 없이 마스크를 사용할 수 없습니다.
* 여러 개의 입력 이미지와 함께 마스크를 사용할 수 없습니다.
* 마스크가 제공되는 경우, 마스크의 크기는 입력 이미지의 크기와 일치해야 합니다.
* `seed` 매개변수는 현재 작동하지 않습니다.

## 출력

| 출력 이름   | 설명                  | 데이터 타입 |
| ------- | ------------------- | ------ |
| `image` | 생성된 이미지 또는 이미지들입니다. | IMAGE  |

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

***

**Source fingerprint (SHA-256):** `a757208cf6cc151594599b35b0ef73f2caf7274189e948799211c0714a6a8f89`
