> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenRouterLLMNode - ComfyUI Built-in Node Documentation

> OpenRouter LLM 节点将文本提示词发送给通过 OpenRouter 服务提供的一组精选热门语言模型，并返回生成的文本响应。

OpenRouter LLM 节点将文本提示词发送给通过 OpenRouter 服务提供的一组精选热门语言模型，并返回生成的文本响应。它支持来自 Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、xAI (Grok)、DeepSeek、Qwen、Mistral、Z.AI (GLM)、Moonshot (Kimi) 以及 Perplexity Sonar 的模型，并且可以选择在请求中包含图片或视频作为参考输入。

## 输入

在 `model` 选择器中选中某个模型后，节点会根据所选模型的能力，在通用输入上方显示模型专属小部件——推理强度、网页搜索大小和/或参考媒体槽位。

### 通用输入

| 参数              | 描述                                 | 数据类型           | 必填 | 范围                 |
| --------------- | ---------------------------------- | -------------- | -- | ------------------ |
| `prompt`        | 输入给模型的文本。                          | STRING         | 是  | N/A                |
| `model`         | 用于生成响应的 OpenRouter 模型。             | DYNAMIC\_COMBO | 是  | 有多个可用选项（参见下方各模型部分） |
| `seed`          | 采样种子。设置为 0 可省略。大多数模型仅将其视为提示。（默认：0） | INT            | 是  | 0 到 2147483647     |
| `system_prompt` | 用于规定模型行为的基础指令。（默认：""）              | STRING         | 否  | N/A                |

### Anthropic Claude 模型输入

以下模型共用：`anthropic/claude-opus-5`、`anthropic/claude-opus-4.8`、`anthropic/claude-opus-4.7`、`anthropic/claude-fable-5`、`anthropic/claude-sonnet-5`、`anthropic/claude-haiku-4.5`。

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

这些模型最多支持 20 张参考图片（参见“参考输入”）。

### OpenAI GPT 模型输入

以下模型共用：`openai/gpt-5.6-sol-pro`、`openai/gpt-5.6-sol`、`openai/gpt-5.6-terra-pro`、`openai/gpt-5.6-terra`、`openai/gpt-5.6-luna-pro`、`openai/gpt-5.6-luna`、`openai/gpt-5.5-pro`、`openai/gpt-5.5`。

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

这些模型最多支持 20 张参考图片（参见“参考输入”）。

### Google Gemini 3.5 Flash 输入

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

该模型最多支持 20 张参考图片和 4 个参考视频（参见“参考输入”）。

### xAI Grok 模型输入

以下模型共用：`x-ai/grok-4.5`、`x-ai/grok-4.20`、`x-ai/grok-4.3`。

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

这些模型最多支持 20 张参考图片（参见“参考输入”）。

### DeepSeek 模型输入

以下模型共用：`deepseek/deepseek-v4-pro`、`deepseek/deepseek-v4-flash`、`deepseek/deepseek-v3.2`。

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

纯文本模型——无参考图片或视频。

### Qwen 3.6 Max Preview 输入

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

纯文本模型——无参考图片或视频。

### Qwen 3.6 Plus 和 Qwen 3.6 Flash 输入

以下模型共用：`qwen/qwen3.6-plus` 和 `qwen/qwen3.6-flash`。

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

这些模型最多支持 10 张参考图片和 4 个参考视频（参见“参考输入”）。

### Mistral Large 2512 输入

无特定配置档位输入（标准配置档位）。该模型最多支持 8 张参考图片（参见“参考输入”）。

### Mistral Medium 3.5 输入

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

该模型最多支持 8 张参考图片（参见“参考输入”）。

### Z.AI GLM 模型输入

以下模型共用：`z-ai/glm-4.6` 和 `z-ai/glm-5`。

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

纯文本模型——无参考图片或视频。

### Moonshot Kimi K3 和 K2.6 输入

以下模型共用：`moonshotai/kimi-k3` 和 `moonshotai/kimi-k2.6`。

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

这些模型最多支持 10 张参考图片（参见“参考输入”）。

### Moonshot Kimi K2 Thinking 输入

| 参数                 | 描述                               | 数据类型  | 必填 | 范围                                         |
| ------------------ | -------------------------------- | ----- | -- | ------------------------------------------ |
| `reasoning_effort` | 推理强度。设为 'off' 时完全禁用推理。（默认："off"） | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

纯文本模型——无参考图片或视频。

### Perplexity Sonar Pro 输入

| 参数                    | 描述                                                | 数据类型  | 必填 | 范围                              |
| --------------------- | ------------------------------------------------- | ----- | -- | ------------------------------- |
| `search_context_size` | 要检索的网页搜索上下文大小。越大 = 结果越可靠，但速度更慢/成本更高。（默认："medium"） | COMBO | 否  | "low"<br />"medium"<br />"high" |

纯文本模型——无参考图片或视频。

### Perplexity Sonar Reasoning Pro 和 Sonar Deep Research 输入

以下模型共用：`perplexity/sonar-reasoning-pro` 和 `perplexity/sonar-deep-research`。

| 参数                    | 描述                                                | 数据类型  | 必填 | 范围                                         |
| --------------------- | ------------------------------------------------- | ----- | -- | ------------------------------------------ |
| `search_context_size` | 要检索的网页搜索上下文大小。越大 = 结果越可靠，但速度更慢/成本更高。（默认："medium"） | COMBO | 否  | "low"<br />"medium"<br />"high"            |
| `reasoning_effort`    | 推理强度。设为 'off' 时完全禁用推理。（默认："off"）                  | COMBO | 否  | "off"<br />"low"<br />"medium"<br />"high" |

纯文本模型——无参考图片或视频。

### 参考输入

| 参数       | 描述                                                                                    | 数据类型  | 必填 | 范围                      |
| -------- | ------------------------------------------------------------------------------------- | ----- | -- | ----------------------- |
| `images` | 可选的参考图片，以 URL 形式发送。可增长输入槽：可连接 1..N 个图像输入（`image_1`、`image_2`……）；数量上限取决于所选模型（参见各模型章节）。 | IMAGE | 否  | 0 到 20（取决于模型：8、10 或 20） |
| `videos` | 可选的参考视频，以 URL 形式发送。可增长输入槽：可连接 1..N 个视频输入（`video_1`、`video_2`……）；数量上限取决于所选模型（参见各模型章节）。 | VIDEO | 否  | 0 到 4（取决于模型）            |

**说明：**

* **可用模型：** 可用的模型选项会动态生成，包含具有不同能力的模型。完整列表（共 34 个模型）如下：
  * Anthropic: `anthropic/claude-opus-5`、`anthropic/claude-opus-4.8`、`anthropic/claude-opus-4.7`、`anthropic/claude-fable-5`、`anthropic/claude-sonnet-5`、`anthropic/claude-haiku-4.5`
  * OpenAI: `openai/gpt-5.6-sol-pro`、`openai/gpt-5.6-sol`、`openai/gpt-5.6-terra-pro`、`openai/gpt-5.6-terra`、`openai/gpt-5.6-luna-pro`、`openai/gpt-5.6-luna`、`openai/gpt-5.5-pro`、`openai/gpt-5.5`
  * Google: `google/gemini-3.5-flash`
  * xAI: `x-ai/grok-4.5`、`x-ai/grok-4.20`、`x-ai/grok-4.3`
  * DeepSeek: `deepseek/deepseek-v4-pro`、`deepseek/deepseek-v4-flash`、`deepseek/deepseek-v3.2`
  * Qwen: `qwen/qwen3.6-max-preview`、`qwen/qwen3.6-plus`、`qwen/qwen3.6-flash`
  * Mistral: `mistralai/mistral-large-2512`、`mistralai/mistral-medium-3-5`
  * Z.AI: `z-ai/glm-4.6`、`z-ai/glm-5`
  * Moonshot: `moonshotai/kimi-k3`、`moonshotai/kimi-k2.6`、`moonshotai/kimi-k2-thinking`
  * Perplexity: `perplexity/sonar-pro`、`perplexity/sonar-reasoning-pro`、`perplexity/sonar-deep-research`

* **图片和视频限制：** 参考图片和视频的最大数量取决于所选模型。如果提供的图片或视频总数超过模型限制，节点会报错。不支持图片或视频的模型不会显示相应的参考输入槽位。

* **推理行为：** 当 `reasoning_effort` 设置为 "off" 以外的任何值时，请求会要求提供商在内部进行推理，而不返回推理轨迹。

* **Seed 行为：** `seed` 参数具有 `control_after_generate` 行为，即根据用户的小部件设置，在每次节点执行后可以自动更改（例如随机化、递增或固定）。

* **系统提示：** `system_prompt` 参数为可选项，并在用户界面中标记为高级参数。

* **错误情况：** 如果提示词在去除首尾空白后为空、OpenRouter 返回错误、所选模型拒绝响应，或响应中不包含任何 choices 或 message，节点都会报错。节点上的价格徽章会根据所选模型显示每 1K 个 token 的近似成本估算。

## 输出

| 输出名      | 描述                      | 数据类型   |
| -------- | ----------------------- | ------ |
| `output` | 从 OpenRouter 模型生成的文本响应。 | STRING |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenRouterLLMNode/zh.md)

***

**Source fingerprint (SHA-256):** `534ab9ecc12e35a23a4d8f3e10f4f82d95db8e902ac8a2f2ee0ea68246516f62`