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

# 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 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="데스크톱 또는 클라우드 사용자">
      * 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
      * [클라우드](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 모델에 표시됩니다

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

## 예시 워크플로우(`api_openrouter_llm`)

아래 템플릿은 **한 가지 예시**이며, 노드를 사용하는 유일한 방법은 아닙니다. 이를 다운로드하여 입력이 어떻게 연결되는지 확인한 후, 자신의 작업에 맞게 그래프를 조정하세요—순수 텍스트 채팅, 캡션 생성, 프롬프트 재작성, 이미지 노드에 문자열 입력, 또는 파이프라인에 적합한 다른 작업에도 활용할 수 있습니다.

<Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_openrouter_llm&utm_source=docs&utm_medium=referral&utm_campaign=openrouter_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>

<Note>
  이 샘플에서는 워크플로우가 참조 이미지를 분석하고 하위 이미지 노드를 위한 텍스트-to-image 프롬프트를 반환합니다. **이미지 로드**를 생략하거나, 프롬프트를 변경하거나, 그래프를 완전히 다시 구성해 자신만의 사용 사례에 맞게 조정할 수 있습니다.
</Note>

템플릿을 참고로 사용한다면 일반적인 실행 과정은 다음과 같습니다:

1. **이미지 로드**에서 참조 이미지를 로드하세요(텍스트 전용 채팅의 경우 생략 가능)
2. **OpenRouter LLM**에서 이미지를 `image_1`에 연결하세요(모델이 지원하는 경우 더 많은 슬롯이 나타납니다)
3. **프롬프트** 설정 — 예를 들어 모델에게 이미지를 분석하고 생성 프롬프트를 출력하도록 요청하세요
4. (선택) 고급 옵션에서 **system\_prompt**을 설정해 어조, 형식 또는 제약 조건을 지정하세요
5. **모델** 선택; 표시될 때 **reasoning\_effort** 또는 **search\_context\_size**를 조정하세요
6. **실행**을 클릭하거나 `Ctrl(cmd) + Enter`를 누르세요
7. **미리 보기**에서 응답을 확인하세요

### 추가 참고사항

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