跳转到主要内容

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 是一个统一的大语言模型路由平台,通过单一 API 对接多家模型服务商,便于在不同模型之间切换而无需更换集成方式。ComfyUI 通过 OpenRouter LLM 合作伙伴节点接入,在一个节点内提供精选的文本与多模态模型——包括 Claude、GPT、Gemini、Grok、DeepSeek、Qwen、Mistral、GLM、Kimi 以及 Perplexity Sonar。
使用 API 节点需要保证你已经正常登录,并在受许可的网络环境下使用,请参考API 节点总览部分文档来了解使用 API 节点的具体使用要求。
请确保你的 ComfyUI 已经更新。本指南里的工作流可以在 ComfyUI 的工作流模板中找到。如果找不到,可能是 ComfyUI 没有更新。如果加载工作流时有节点缺失,可能原因有:
  1. 你用的不是最新开发版(nightly)。
  2. 你用的是稳定版或桌面版(没有包含最新的更新)。
  3. 启动时有些节点导入失败。

能做什么

  • 文本对话 — 使用 prompt,可选 system_prompt 设定角色或任务
  • 视觉理解 — 在支持的模型上连接参考图(可连接数量因模型而异)
  • 视频输入 — Gemini 3.5 Flash、Qwen 3.6 Plus/Flash 支持可选参考视频
  • 推理模式 — 推理类 / 前沿推理类模型可设置 reasoning_effortofflowmediumhigh
  • 联网搜索 — Perplexity Sonar 系列可设置 search_context_size 获取带检索上下文的回答
各模型 token 价格见 合作伙伴节点定价

支持的模型

模型视觉(最多图片数)视频额外选项
anthropic/claude-opus-4.720推理强度
openai/gpt-5.5-pro20推理强度
openai/gpt-5.520推理强度
google/gemini-3.5-flash20最多 4 个推理强度
x-ai/grok-4.2020推理强度
x-ai/grok-4.320推理强度
deepseek/deepseek-v4-pro推理强度
deepseek/deepseek-v4-flash推理强度
deepseek/deepseek-v3.2推理强度
qwen/qwen3.6-max-preview推理强度
qwen/qwen3.6-plus10最多 4 个推理强度
qwen/qwen3.6-flash10最多 4 个推理强度
mistralai/mistral-large-25128
mistralai/mistral-medium-3-58推理强度
z-ai/glm-4.6推理强度
z-ai/glm-5推理强度
moonshotai/kimi-k2.610推理强度
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

下方模板 仅作示例,并非唯一用法。你可以下载参考节点如何连接,再按自己的任务改图——纯文本问答、图像描述、提示词改写、把字符串接到图像节点等都可以。

下载工作流

下载 JSON 或在模板库中搜索 “OpenRouter LLM”
该示例会分析参考图并输出文生图提示词,供下游图像节点使用。你也可以去掉 Load Image、修改提示词,或完全按自己的需求重新搭建工作流。
若以该模板为参考,一次典型运行大致如下:
  1. Load Image 中加载参考图(纯文本对话可跳过)
  2. OpenRouter LLM 中将图片连到 image_1(支持多图时会出现更多槽位)
  3. 填写 prompt — 例如让模型分析图片并输出生成提示词
  4. (可选)在高级选项中设置 system_prompt,约束语气、格式或任务
  5. 选择 model;若有 reasoning_effortsearch_context_size 可按需调整
  6. 点击 Run 或按 Ctrl(cmd) + Enter 执行
  7. Preview Any 中查看返回文本

补充说明

  • seed — 设为 0 表示不传;多数模型仅将其视为提示,结果仍可能不同
  • 参考图、参考视频在运行工作流时自动上传,你只需在图中连接 ComfyUI 的图像/视频输出
  • 各模型价格见 定价页 OpenRouter 章节