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

# GPT-6 Astra ComfyUI 공식 예제

> OpenAI Chat 파트너 노드를 통해 OpenAI GPT-6 Astra를 사용하여 복잡한 추론, 이미지 분석, 프롬프트 생성 등 LLM 기반 워크플로를 구성하는 방법을 소개합니다

**GPT-6 Astra** 는 OpenAI의 가장 강력한 모델로, 가장 어려운 엔드투엔드 작업을 위해 구축되었습니다: 복잡한 추론, 코딩, 컴퓨터 조작, 리서치, 문서 작성. 2026년 9월 3일에 출시되었으며, 1,050,000 토큰 컨텍스트 윈도우, 텍스트 및 이미지 입력, `low`부터 `max`까지의 reasoning effort 레벨을 지원합니다.

ComfyUI에서는 GPT-6 Astra를 `OpenAI Chat` 노드를 통해 실행합니다: 노드의 `model` 드롭다운에서 `gpt-6-astra`를 선택하세요. 이 페이지는 ComfyUI 워크플로에서 모델을 사용하는 방법에 중점을 둡니다. 모든 모델에 공통되는 노드 기본 사용법은 [OpenAI Chat 튜토리얼](/ko/tutorials/partner-nodes/openai/chat)을 참조하세요.

<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 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

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

## GPT-6 Astra를 선택해야 하는 경우

`OpenAI Chat` 노드에는 `gpt-5-nano`부터 `gpt-6-astra`까지 다양한 모델이 있습니다. GPT-6 Astra는 가장 강력하지만 가장 비싸므로, 저렴한 모델이 어려워하는 작업에 적합합니다:

* **긴 컨텍스트 이미지 분석**: `Batch Images`로 여러 이미지나 큰 프롬프트 파일을 입력하고 한 번에 구조화된 분석 수행
* **프롬프트 엔지니어링**: 참조 이미지나 대략적인 아이디어를 이미지·비디오 모델용 상세한 쉼표 구분 positive 프롬프트로 변환
* **에이전트형 워크플로**: 데이터셋 설명 분석, 생성 계획 수립, 프롬프트 작성 같은 다단계 작업
* **복잡한 지시 이행**: JSON, YAML, 고정 섹션 순서 등 작은 모델이 자주 깨는 정확한 출력 형식

단순한 캡션이나 짧은 답변에는 `gpt-5`나 `gpt-5-mini`도 저렴한 비용으로 좋은 결과를 냅니다. 모델별 요금은 [가격표](/ko/tutorials/partner-nodes/pricing)를 참조하세요.

## OpenAI Chat 노드에서 모델 사용하기

`OpenAI Chat` 노드의 입력:

* `prompt`: 지시문. 프롬프트 생성 작업에서는 이미지에서 무엇을 추출하고 어떤 출력 형식을 원하는지 정확히 기술합니다
* `images`: 선택적 이미지 컨텍스트. `LoadImage`를 연결하고, 여러 이미지는 `Batch Images`를 사용합니다. 연결된 모든 이미지가 모델에 전송됩니다
* `files`: `OpenAI Chat Input Files` 노드의 선택적 문서
* `advanced_options`: `OpenAI Chat Advanced Options` 노드의 선택적 설정

출력은 `String`입니다. 대표적인 다운스트림 활용:

* `Preview Any` 노드에 연결하여 응답 확인
* `Save Text`에 연결하여 생성된 프롬프트를 `.txt` 파일로 저장
* `CLIP Text Encode` 노드의 positive 프롬프트 입력에 연결하여, LLM이 프롬프트를 작성하는 완전 자동화된 이미지·비디오 생성 파이프라인 구축
* 파트너 노드의 텍스트 입력에 연결하여, 비디오 생성 전 장면 설명 초안 작성 등에 활용

## 추론 effort

GPT-6 Astra는 추론 모델입니다. `OpenAI Chat Advanced Options` 노드를 연결하고 `reasoning_effort`를 설정하여 응답 품질과 비용의 균형을 조절할 수 있습니다:

| 레벨        | 동작                     |
| --------- | ---------------------- |
| `default` | 모델이 자동 선택              |
| `low`     | 가장 빠르고 저렴. 단순한 분석에 적합  |
| `medium`  | 프롬프트 생성의 균형 잡힌 기본값     |
| `high`    | 복잡한 이미지나 지시에 대한 철저한 분석 |
| `xhigh`   | 깊은 다단계 추론              |
| `max`     | 가장 어려운 작업의 최대 추론       |

같은 노드에는 `max_output_tokens`(16\~16384, 추론 토큰 포함)와 `instructions` 필드도 있습니다. `instructions`는 영구 시스템 프롬프트 역할을 하며, 여러 번 실행할 때 출력 형식을 고정하는 데 유용합니다.

## GPT-6 Astra 템플릿

별도의 템플릿은 GPT-6 Astra가 이미지를 분석하고 이를 기반으로 구조화된 AI 아트 프롬프트를 생성하는 과정을 보여줍니다. 이 워크플로는 이미지를 로드하고, `model`이 `gpt-6-astra`로 설정된 `OpenAI Chat` 노드에 분석 프롬프트를 전송한 후, `Save Text`를 통해 결과를 텍스트 파일로 저장합니다.

![GPT-6 Astra 워크플로 미리보기](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_openai_gpt6_astra-1.webp)

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_openai_gpt6_astra&utm_source=docs&utm_medium=referral&utm_campaign=gpt6-astra">
    Comfy Cloud에서 실행
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_openai_gpt6_astra.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "GPT-6 Astra"를 검색하세요
  </Card>
</CardGroup>

**입력 소재**

다음 파일을 해당 `LoadImage` 노드에 업로드하세요:

<CardGroup cols={2}>
  <Card title="blue_poppies_field.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/blue_poppies_field.png">
    `LoadImage` 노드 · `blue_poppies_field.png`
  </Card>
</CardGroup>

단계:

1. `LoadImage` 노드에서 이미지를 로드합니다
2. `OpenAI Chat` 노드에서 필요에 따라 분석 프롬프트를 조정하거나 `model`을 전환합니다. 템플릿의 프롬프트는 피사체, 구도, 카메라, 조명, 색감, 질감, 스타일을 추출하고 쉼표 구분 positive 프롬프트만 출력하도록 모델에 지시합니다
3. `Run`을 클릭합니다. 생성된 프롬프트는 미리보기에 표시되며 `Save Text` 노드를 통해 `.txt` 파일로 저장됩니다

더 나아가려면 저장한 프롬프트를 `CLIP Text Encode` 노드나 이미지·비디오 모델 노드에 복사하여, 모델의 출력으로 바로 생성할 수 있습니다.

GPT-6 Astra는 API 토큰 사용량을 기준으로 청구되며, 다른 OpenAI Chat 모델보다 요율이 높습니다. 자세한 내용은 [가격표](/ko/tutorials/partner-nodes/pricing)를 참조하세요.
