必须使用openrouter统一api实现多模型共用一套配置，其通过单一端点和model参数驱动切换gpt-5、claude opus 4.6等模型；需获取sk-or-v1-前缀密钥、在dify中配置openai兼容类型供应商，并手动添加非chat类模型以支持多模态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中让GPT-5、Claude Opus 4.6、Gemini 3、Qwen 3等前沿模型共用一套配置、按需切换，而不是为每个模型单独填API Key和地址，就必须走OpenRouter统一API这条路——它把多厂商、多模态、多协议的模型能力收束到一个端点，Dify只需认准这个入口，后续全靠model参数驱动。
获取并验证OpenRouter API Key
打开 OpenRouter控制台 Keys 页面，点击「Create new key」生成密钥；复制刚生成的 sk-or-v1- 开头的密钥，不要漏掉任何字符。
在终端执行测试命令验证密钥有效性：curl -X POST "https://openrouter.ai/api/v1/chat/completions" -H "Authorization: Bearer sk-or-v1-xxx" -H "Content-Type: application/json" -d '{"model":"google/gemini-pro","messages":[{"role":"user","content":"hi"}]}'。如果返回含"choices"字段的JSON，说明密钥可用；若报401 Unauthorized，请检查密钥是否复制完整或是否被误删空格。
【密钥必须带 sk-or-v1- 前缀，旧式 sk- 或其他平台密钥无法通过验证】
在Dify中添加OpenRouter为模型供应商
登录Dify后台 → 点击右上角头像 → 「设置」→ 左侧菜单选择「模型供应商」→ 点击「+ 添加模型供应商」。
在弹出窗口中：
① 供应商名称填「OpenRouter」（可自定义，但建议保持清晰）；
② 类型选「OpenAI-API-compatible」；
③ API Key 粘贴上一步复制的 sk-or-v1-xxx 密钥；
④ Base URL 填 https://openrouter.ai/api/v1；
⑤ 点击「保存」。
保存后Dify会自动尝试连接并拉取模型列表。若右侧「可用模型」区域显示为空或报错「Failed to fetch models」，请确认Base URL末尾没有多余斜杠（如https://openrouter.ai/api/v1/会导致失败）。
配置具体模型并启用多模态能力
方法一：使用Dify自动发现的模型
保存供应商后，等待10秒左右，刷新页面，「可用模型」列表中会出现类似 anthropic/claude-3.5-sonnet、google/gemini-3-pro、qwen/qwen-3 的条目。勾选需要启用的模型 → 点击「启用」即可立即在工作流中调用。
方法二：手动注册未自动列出的模型（如图像生成类）
进入「模型供应商」→ 找到刚添加的OpenRouter条目 → 点击「编辑」→ 滚动到底部「自定义模型」区域 → 点击「+ 添加模型」→ 填写：
模型名称：black-forest-labs/flux-schnell（示例图像模型）
模型类型：选「text-to-image」
是否启用：开启开关
→ 保存。该模型将出现在「可用模型」中，且可在Image Generation节点中直接选用。
【text-to-image、embedding、transcription 类模型必须手动添加，Dify不会自动识别非chat类型】
在工作流中调用并验证跨模型一致性
新建一个Workflow → 拖入一个「LLM」节点 → 在模型下拉框中选择 anthropic/claude-3.5-sonnet → 输入提示词「用中文写一段关于夏季星空的100字描写」→ 点击「运行测试」。
测试成功后，不修改任何其他参数，仅将模型切换为 google/gemini-3-pro → 再次运行。两次输出风格不同，但结构一致、无报错、响应时间均在合理范围（通常1–4秒），证明统一API路由已生效。
若某次运行卡在「Loading…」超过15秒，检查该模型是否在OpenRouter官网状态页标记为 Degraded 或 Outage，此时应临时切换至其他可用模型，无需改动Dify配置。
