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

# OpenAI GPT-Image-1 노드

> ComfyUI에서 이미지를 생성하는 데 OpenAI GPT-Image-1 파트너 노드를 사용하는 방법을 알아보세요.

<img src="https://mintcdn.com/dripart/Rig0_LOInmwVbVSB/images/comfy_core/api_nodes/openai-gpt-image-1.jpg?fit=max&auto=format&n=Rig0_LOInmwVbVSB&q=85&s=243b4200a707b55f1c4fd88d4edf51a9" alt="OpenAI GPT-Image-1 노드 스크린샷" width="1576" height="1123" data-path="images/comfy_core/api_nodes/openai-gpt-image-1.jpg" />

OpenAI GPT-Image-1은 ComfyUI 파트너 노드 시리즈의 일부로, 사용자가 OpenAI의 **GPT-Image-1** 모델을 통해 이미지를 생성할 수 있도록 합니다. 이 모델은 ChatGPT 4o에서 이미지 생성에 사용되는 것과 동일합니다.

이 노드는 다음을 지원합니다:

* 텍스트 기반 이미지 생성
* 이미지 편집 기능(마스크를 통한 인페인팅)

## 노드 개요

**OpenAI GPT-Image-1** 노드는 OpenAI의 이미지 생성 API를 통해 동기식으로 이미지를 생성합니다. 텍스트 프롬프트를 입력받아 설명과 일치하는 이미지를 반환합니다. GPT-Image-1은 현재 이용 가능한 OpenAI의 가장 고급 이미지 생성 모델로, 매우 세밀하고 사실적인 이미지를 만들 수 있습니다.

<Tip>
  파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](/ko/tutorials/partner-nodes/overview) 섹션을 참조해 주세요.
</Tip>

<Tip>
  <Tabs>
    <Tab title="휴대용 또는 자체 배포 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다. (데스크톱 버전의 업데이트는 다소 지연될 수 있습니다)

      워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="데스크톱 또는 클라우드 사용자">
      * 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

## 매개변수 설명

### 필수 매개변수

| 매개변수     | 유형  | 설명                           |
| -------- | --- | ---------------------------- |
| `prompt` | 텍스트 | 생성하려는 이미지의 내용을 설명하는 텍스트 프롬프트 |

### 위젯 매개변수

| 매개변수         | 유형 | 옵션                                    | 기본값    | 설명                        |
| ------------ | -- | ------------------------------------- | ------ | ------------------------- |
| `seed`       | 정수 | 0-2147483647                          | 0      | 생성 결과를 제어하는 데 사용되는 난수 시드  |
| `quality`    | 옵션 | low, medium, high                     | low    | 이미지 품질 설정, 비용 및 생성 시간에 영향 |
| `background` | 옵션 | opaque, transparent                   | opaque | 반환된 이미지에 배경이 있는지 여부       |
| `size`       | 옵션 | auto, 1024x1024, 1024x1536, 1536x1024 | auto   | 생성된 이미지의 크기               |
| `n`          | 정수 | 1-8                                   | 1      | 생성할 이미지의 수                |

### 선택적 매개변수

| 매개변수    | 유형  | 옵션         | 기본값 | 설명                            |
| ------- | --- | ---------- | --- | ----------------------------- |
| `image` | 이미지 | 임의의 이미지 입력 | 없음  | 이미지 편집을 위한 선택적 참조 이미지         |
| `mask`  | 마스크 | 마스크 입력     | 없음  | 인페인팅을 위한 선택적 마스크 (흰색 영역이 교체됨) |

## 사용 예시

### 텍스트 기반 이미지 생성 예시

아래 이미지는 간단한 텍스트 기반 이미지 워크플로우를 포함하고 있습니다. 이미지를 다운로드하여 ComfyUI로 드래그해 해당 워크플로우를 로드해 보세요.
![ComfyUI openai-gpt-image-1 워크플로우](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/GPT-Image-1/text2image.png)

해당 워크플로우는 매우 간단합니다:

<img src="https://mintcdn.com/dripart/OVkvfOwYrH10fL3Y/images/tutorial/api_nodes/openai/gpt-image-1/text2image.jpg?fit=max&auto=format&n=OVkvfOwYrH10fL3Y&q=85&s=e7308997e027153d914a61418a9c0058" alt="ComfyUI openai-gpt-image-1 워크플로우 예시" width="3580" height="1956" data-path="images/tutorial/api_nodes/openai/gpt-image-1/text2image.jpg" />

`OpenAI GPT-Image-1` 노드를 로드하고, `prompt` 노드에 생성하려는 이미지의 설명을 입력한 후, `Save Image` 노드를 연결한 다음 워크플로우를 실행하기만 하면 됩니다.

### 이미지 기반 이미지 생성 예시

아래 이미지는 간단한 이미지 기반 이미지 워크플로우를 포함하고 있습니다. 이미지를 다운로드하여 ComfyUI로 드래그해 해당 워크플로우를 로드해 보세요.
![ComfyUI openai-gpt-image-1 워크플로우](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/GPT-Image-1/image2image.png)

다음 이미지를 입력으로 사용하겠습니다:
![ComfyUI openai-gpt-image-1 워크플로우 입력](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/GPT-Image-1/input.webp)

이 워크플로우에서는 `OpenAI GPT-Image-1` 노드를 사용해 이미지를 생성하고, `Load Image` 노드를 사용해 입력 이미지를 로드한 다음, 이를 `OpenAI GPT-Image-1` 노드의 `image` 입력에 연결합니다.

<img src="https://mintcdn.com/dripart/OVkvfOwYrH10fL3Y/images/tutorial/api_nodes/openai/gpt-image-1/image2image.jpg?fit=max&auto=format&n=OVkvfOwYrH10fL3Y&q=85&s=05cab30de9ab5bc2e0865c0a367f82fc" alt="ComfyUI openai-gpt-image-1 워크플로우 예시" width="3180" height="1114" data-path="images/tutorial/api_nodes/openai/gpt-image-1/image2image.jpg" />

### 여러 이미지 입력 예시

아래 이미지를 다운로드하여 ComfyUI로 드래그해 해당 워크플로우를 로드해 보세요.

![여러 이미지 입력 예시](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/GPT-Image-1/multiple_image_input.png)

다음 모자 이미지를 추가 입력 이미지로 사용하겠습니다.
![모자](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/GPT-Image-1/hat.webp)

해당 워크플로우는 아래 이미지와 같습니다:

<img src="https://mintcdn.com/dripart/OVkvfOwYrH10fL3Y/images/tutorial/api_nodes/openai/gpt-image-1/multi_images_input.png?fit=max&auto=format&n=OVkvfOwYrH10fL3Y&q=85&s=125236ed762b17ae1e711fa702663f74" alt="여러 이미지 입력 예시" width="1432" height="748" data-path="images/tutorial/api_nodes/openai/gpt-image-1/multi_images_input.png" />

`Batch Images` 노드를 사용해 여러 이미지를 `OpenAI GPT-Image-1` 노드에 로드합니다.

### 인페인팅 워크플로우

GPT-Image-1은 이미지 편집 기능도 지원하며, 마스크를 사용해 교체할 영역을 지정할 수 있습니다. 아래는 간단한 인페인팅 워크플로우 예시입니다:

아래 이미지를 다운로드하여 ComfyUI로 드래그해 해당 워크플로우를 로드해 보세요. 이미지 기반 이미지 생성 섹션에서 사용한 입력 이미지를 계속 사용하겠습니다.

![ComfyUI openai-gpt-image-1 워크플로우](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/GPT-Image-1/inpaint.png)

해당 워크플로우는 아래 이미지와 같습니다:

<img src="https://mintcdn.com/dripart/OVkvfOwYrH10fL3Y/images/tutorial/api_nodes/openai/gpt-image-1/inpaint.jpg?fit=max&auto=format&n=OVkvfOwYrH10fL3Y&q=85&s=12d74944bf8905025606740b820918a8" alt="ComfyUI openai-gpt-image-1 워크플로우 예시" width="3154" height="1156" data-path="images/tutorial/api_nodes/openai/gpt-image-1/inpaint.jpg" />

이미지 기반 이미지 생성 워크플로우와 비교하면, `Load Image` 노드에서 마우스 오른쪽 클릭 메뉴를 통해 MaskEditor를 사용해 마스크를 그린 다음, 이를 `OpenAI GPT-Image-1` 노드의 `mask` 입력에 연결해 워크플로우를 완성합니다.

**참고사항**

* 마스크와 이미지는 반드시 같은 크기여야 합니다.
* 큰 이미지를 입력할 경우, 노드가 자동으로 이미지를 적절한 크기로 조정합니다.

## FAQ

<AccordionGroup>
  <Accordion title="왜 파트너 노드를 찾을 수 없나요?">
    ComfyUI를 최신 버전으로 업데이트해 주세요(최신 커밋 또는 최신 [데스크톱 버전](https://www.comfy.org/download)). 향후 더 많은 API 지원을 추가하고 해당 노드도 업데이트될 예정이니, ComfyUI를 항상 최신 상태로 유지해 주세요.

    <Tip>
      야간 빌드와 릴리즈 버전을 구분해야 한다는 점에 유의해 주세요. 경우에 따라 최신 `릴리즈` 버전이 `야간` 버전보다 제때 업데이트되지 않을 수 있습니다. 아직 빠르게 반복 개발 중이므로, 해당 노드를 찾을 수 없는 경우 반드시 최신 버전을 사용해 주세요.
    </Tip>
  </Accordion>

  <Accordion title="왜 파트너 노드를 사용하거나 로그인할 수 없나요?">
    API 접근을 위해서는 현재 요청이 안전한 네트워크 환경을 기반으로 해야 합니다. 현재 API 접근 요구사항은 다음과 같습니다:

    * 로컬 네트워크는 `127.0.0.1` 또는 `localhost`에서만 접속을 허용하므로, LAN 환경에서 `--listen` 매개변수로 시작된 ComfyUI 서비스에서는 파트너 노드를 사용할 수 없습니다.
    * 당사 API 서비스에 정상적으로 접근 가능해야 합니다(일부 지역에서는 프록시 서비스가 필요할 수 있음).
    * 계정에 충분한 [크레딧](/ko/interface/credits)이 있어야 합니다.
  </Accordion>

  <Accordion title="로그인 후에도 왜 파트너 노드를 사용할 수 없거나 계속해서 로그인을 요구하나요?">
    * 현재 `127.0.0.1` 또는 `localhost` 접속만 지원됩니다.
    * 계정에 충분한 크레딧이 있는지 확인해 주세요.
  </Accordion>

  <Accordion title="파트너 노드는 무료로 사용할 수 있나요?">
    파트너 노드는 폐쇄형 모델에 대한 API 호출에 크레딧이 필요하므로, 무료 사용을 지원하지 않습니다.
  </Accordion>

  <Accordion title="크레딧을 어떻게 구매하나요?">
    다음 문서를 참고해 주세요:

    1. [Comfy 계정](/ko/interface/user): 설정 메뉴에서 `사용자` 섹션을 찾아 로그인하세요.
    2. [크레딧](/ko/interface/credits): 로그인 후 설정 인터페이스에 크레딧 메뉴가 표시됩니다. `설정` → `크레딧`에서 크레딧을 구매할 수 있습니다. 선불 방식을 사용하므로 예상치 못한 요금 청구는 없습니다.
    3. Stripe를 통해 결제를 완료하세요.
    4. 크레딧이 업데이트되었는지 확인하세요. 그렇지 않은 경우 페이지를 다시 시작하거나 새로고침해 보세요.
  </Accordion>

  <Accordion title="미사용 크레딧은 환불받을 수 있나요?">
    현재 크레딧에 대한 환불은 지원되지 않습니다. 기술적 문제로 인해 미사용 잔액이 발생했다고 판단되는 경우, [지원팀에 문의](mailto:support@comfy.org)해 주세요.
  </Accordion>

  <Accordion title="크레딧이 마이너스로 갈 수 있나요?">
    크레딧은 마이너스 잔액이나 신용 한도로 사용하도록 설계되지 않았습니다. 그러나 경합 조건으로 인해 파트너 노드가 실행 전에 항상 비용을 보고하지 않는 경우, 한 번의 실행으로 남은 잔액보다 더 많은 크레딧을 소모해 일시적으로 마이너스 잔액이 될 수 있습니다. 잔액이 마이너스인 경우, 충전해 양수 잔액을 복원할 때까지 파트너 노드를 실행할 수 없습니다. API 호출 전에 충분한 크레딧이 있는지 확인해 주세요.
  </Accordion>

  <Accordion title="사용량과 지출 내역은 어디서 확인할 수 있나요?">
    로그인 후 [크레딧](/ko/interface/credits) 메뉴를 방문해 해당 크레딧을 확인해 주세요.
  </Accordion>

  <Accordion title="내 API 키를 사용할 수 있나요?">
    현재 파트너 노드는 아직 테스트 단계이며 이 기능을 지원하지 않지만, 추가하는 것을 고려하고 있습니다.
  </Accordion>

  <Accordion title="크레딧은 만료되나요?">
    예, 만료 기간은 크레딧 종류에 따라 다릅니다:

    * **월간 크레딧**: 청구 주기 종료 시 만료
    * **충전형 크레딧**: 구매일로부터 1년 후 만료
  </Accordion>

  <Accordion title="크레딧을 이전하거나 공유할 수 있나요?">
    아니요, 귀하의 크레딧은 다른 사용자에게 이전할 수 없으며 현재 로그인된 계정에만 한정됩니다. 다만, 로그인 가능한 기기 수에는 제한이 없습니다.
  </Accordion>

  <Accordion title="동일한 계정을 여러 기기에서 사용할 수 있나요?">
    로그인 가능한 기기 수에는 제한이 없으므로, 원하는 곳에서 계정을 사용할 수 있습니다.
  </Accordion>

  <Accordion title="내 계정이나 정보를 삭제해 달라고 요청하려면 어떻게 하나요?">
    [support@comfy.org](mailto:support@comfy.org)로 이메일을 보내주시면 귀하의 정보를 삭제해 드립니다.
  </Accordion>
</AccordionGroup>