> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-b886298.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenRouter LLM 파트너 노드 ComfyUI 공식 예시

> ComfyUI에서 OpenRouter LLM 파트너 노드를 사용해 여러 프론티어 모델을 통해 채팅, 추론, 비전 및 웹 기반 답변을 제공하세요.

[OpenRouter](https://openrouter.ai)는 대규모 언어 모델을 위한 통합 라우팅 플랫폼입니다. 하나의 API를 통해 다양한 제공자를 노출하므로 통합을 변경하지 않고도 모델을 전환할 수 있습니다. ComfyUI는 **OpenRouter LLM** 파트너 노드를 통해 연결되며, 이 노드는 Claude, GPT, Gemini, Grok, DeepSeek, Qwen, Mistral, GLM, Kimi, Perplexity Sonar 등 텍스트 및 멀티모달 모델의 엄선된 목록을 단일 노드에서 제공합니다.

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

## 할 수 있는 일

* **텍스트 채팅**: 역할이나 작업 지침을 위한 프롬프트와 선택적 `system_prompt`
* **비전**: 지원되는 모델에 참조 이미지를 첨부하세요 (슬롯 수는 모델에 따라 다름)
* **비디오 입력**: Gemini 3.5 Flash 및 Qwen 3.6 Plus/Flash는 선택적 참조 비디오를 지원합니다
* **추론**: 추론 / 프론티어 추론 모델에 대한 `reasoning_effort`(`off`, `low`, `medium`, `high`)
* **웹 검색**: Perplexity Sonar 모델은 근거 있는 답변을 위해 `search_context_size`를 노출합니다

토큰 가격은 [파트너 노드 가격](/ko/tutorials/partner-nodes/pricing#openrouter)에서 확인하실 수 있습니다.

## 지원되는 모델

| 모델                               | 비전(최대 이미지 수) | 비디오   | 추가 옵션             |
| :------------------------------- | :----------- | :---- | :---------------- |
| `anthropic/claude-opus-4.7`      | 20           | —     | 추론 노력             |
| `openai/gpt-5.5-pro`             | 20           | —     | 추론 노력             |
| `openai/gpt-5.5`                 | 20           | —     | 추론 노력             |
| `google/gemini-3.5-flash`        | 20           | 최대 4개 | 추론 노력             |
| `x-ai/grok-4.20`                 | 20           | —     | 추론 노력             |
| `x-ai/grok-4.3`                  | 20           | —     | 추론 노력             |
| `deepseek/deepseek-v4-pro`       | —            | —     | 추론 노력             |
| `deepseek/deepseek-v4-flash`     | —            | —     | 추론 노력             |
| `deepseek/deepseek-v3.2`         | —            | —     | 추론 노력             |
| `qwen/qwen3.6-max-preview`       | —            | —     | 추론 노력             |
| `qwen/qwen3.6-plus`              | 10           | 최대 4개 | 추론 노력             |
| `qwen/qwen3.6-flash`             | 10           | 최대 4개 | 추론 노력             |
| `mistralai/mistral-large-2512`   | 8            | —     | —                 |
| `mistralai/mistral-medium-3-5`   | 8            | —     | 추론 노력             |
| `z-ai/glm-4.6`                   | —            | —     | 추론 노력             |
| `z-ai/glm-5`                     | —            | —     | 추론 노력             |
| `moonshotai/kimi-k2.6`           | 10           | —     | 추론 노력             |
| `moonshotai/kimi-k2-thinking`    | —            | —     | 추론 노력             |
| `perplexity/sonar-pro`           | —            | —     | 검색 컨텍스트 크기        |
| `perplexity/sonar-reasoning-pro` | —            | —     | 검색 컨텍스트 크기, 추론 노력 |
| `perplexity/sonar-deep-research` | —            | —     | 검색 컨텍스트 크기, 추론 노력 |

## 모델별 입력

**모델** 드롭다운은 동적 콤보입니다. 모델을 변경하면 노드가 표시되는 입력을 업데이트합니다:

* **이미지 슬롯**: 비전 가능 모델에만 표시되며, 슬롯 수는 모델 한도와 일치합니다.
* **비디오 슬롯**: Gemini 3.5 Flash 및 Qwen 3.6 Plus/Flash에만 표시됩니다.
* **추론 노력**: 추론 및 프론티어 추론 모델에 표시됩니다.
* **검색 컨텍스트 크기**: Perplexity Sonar 모델에 표시됩니다.

텍스트 전용 모델은 이미지 및 비디오 입력을 숨깁니다.

<h3 id="api_openrouter_llm">
  OpenRouter LLM
</h3>

OpenRouter의 선별된 목록(Claude, GPT, Gemini 등)에서 모델을 선택하세요. 비전 가능 모델의 경우 선택적 미디어 업로드와 함께 텍스트 응답을 생성합니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_openrouter_llm-1.webp" alt="OpenRouter LLM 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_openrouter_llm&utm_source=docs&utm_medium=referral&utm_campaign=llm">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_openrouter_llm.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "OpenRouter LLM" 검색
  </Card>
</CardGroup>

**입력 자료**

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

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

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/contact_sheet_app_input_1.png" alt="contact_sheet_app_input_1.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

<Note>
  이 샘플에서 워크플로는 참조 이미지를 분석하고 다운스트림 이미지 노드를 위한 텍스트 기반 이미지 생성 프롬프트를 반환합니다. **Load Image**를 생략하거나, 프롬프트를 변경하거나, 사용 사례에 맞게 그래프를 완전히 재구성할 수 있습니다.
</Note>

템플릿을 참조용으로 사용하는 경우 일반적인 실행은 다음과 같습니다:

1. **Load Image**에서 참조 이미지를 로드합니다(텍스트 전용 채팅에서는 건너뜁니다).
2. **OpenRouter LLM**에서 이미지를 `image_1`에 연결합니다(모델이 지원하는 경우 더 많은 슬롯이 나타납니다).
3. **prompt**를 설정합니다(예: 모델에게 이미지를 분석하고 생성 프롬프트를 출력하도록 요청).
4. (선택 사항) 어조, 형식 또는 제약 조건을 위해 고급 옵션에서 **system\_prompt**를 설정합니다.
5. **model**을 선택하고, **reasoning\_effort** 또는 **search\_context\_size**가 표시되면 조정합니다.
6. **Run**을 클릭하거나 `Ctrl(cmd) + Enter`를 누릅니다.
7. **Preview Any**에서 응답을 확인합니다.

### 추가 참고 사항

* **seed**: 생략하려면 `0`으로 설정하세요. 대부분의 모델은 이를 힌트로만 취급합니다.
* 참조 이미지와 비디오는 워크플로 실행 시 자동으로 업로드됩니다. 노드에는 ComfyUI 이미지/비디오 출력만 연결하면 됩니다.
* 모델별 가격은 [가격 페이지의 OpenRouter](/ko/tutorials/partner-nodes/pricing#openrouter)를 참조하세요.