> ## 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>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="便携版或手动安装用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在 ComfyUI 的[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新开发版（nightly）。
      2. 你用的是稳定版或桌面版（没有包含最新的更新）。
      3. 启动时有些节点导入失败。
    </Tab>

    <Tab title="桌面版或云端用户">
      * 桌面版是基于 ComfyUI 稳定版本构建的，它会在有新的桌面稳定版本发布时自动更新。
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新，我们会同步更新 Cloud。

      所以，如果你发现本教程中有任何核心节点缺失，那是因为对应的节点支持还在开发中没有发布正式的稳定版，请等待下一个稳定版本发布。
    </Tab>
  </Tabs>
</Tip>

## 能做什么

* **文本对话** — 使用 `prompt`，可选 `system_prompt` 设定角色或任务
* **视觉理解** — 在支持的模型上连接参考图（可连接数量因模型而异）
* **视频输入** — Gemini 3.5 Flash、Qwen 3.6 Plus/Flash 支持可选参考视频
* **推理模式** — 推理类 / 前沿推理类模型可设置 `reasoning_effort`（`off`、`low`、`medium`、`high`）
* **联网搜索** — Perplexity Sonar 系列可设置 `search_context_size` 获取带检索上下文的回答

各模型 token 价格见 [合作伙伴节点定价](/zh/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` | —         | —      | 搜索上下文大小、推理强度 |

## 随模型变化的输入项

**model** 为动态下拉：切换模型后，节点会更新显示的输入项：

* **图片槽位** — 仅视觉模型显示，数量与模型上限一致
* **视频槽位** — 仅 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>
  该示例会分析参考图并输出文生图提示词，供下游图像节点使用。你也可以去掉 **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 章节](/zh/tutorials/partner-nodes/pricing#openrouter)