ToRouter 文档集成指南
Dify 与 n8n（无代码）
通过 Dify 与 n8n 的 OpenAI 兼容提供方插槽，把工作流接入 ToRouter。
Dify 与 n8n 都内置了 "OpenAI 兼容" 提供方，支持自定义 Base URL——指向 ToRouter 即可在工作流与节点中使用目录里的任何模型。
配置
| 配置项 | 说明 |
|---|---|
| API endpoint / Base URL | https://portal.torouter.ai/v1 |
| API Key | sk-*** |
| 模型名 | gpt-5、claude-opus-4-7、gemini-2.5-pro 等 |
Dify
打开模型提供方
在 Dify 中前往 Settings → Model Provider（右上角头像 → Settings）。
添加 OpenAI-API-compatible
在提供方列表中找到 OpenAI-API-compatible，点击 Setup。
填入 ToRouter
- Model Name：从模型目录 复制模型 ID，例如
claude-opus-4-7 - API Key：
sk-*** - API endpoint URL：
https://portal.torouter.ai/v1 - Completion mode：
Chat - 其余字段保持默认
点击 Save，Dify 会发送一次小请求验证。
在工作流中使用
在任意工作流 / Chatflow 的 LLM 节点中，刚加好的模型就会出现在模型选择器里。
n8n
添加 OpenAI Chat Model 节点
在工作流中加入 OpenAI Chat Model 节点（位于 AI / LangChain 类别）。
新建凭据
点击 Credentials → Create New，选择 OpenAI API。
- API Key：
sk-*** - Base URL：
https://portal.torouter.ai/v1
保存。
指定模型
在节点的 Model 字段输入模型 ID（例如 gpt-5）。自定义 Base URL 时下拉框不会自动列出模型，手动输入即可。
易踩的坑
- 在 Dify 中，Model Name 是按模型逐个添加的——每条记录对应一个可用插槽。需要再加模型时重新打开提供方配置。
- Dify 保存时会缓存模型能力信息；如果新增模型类型报错，重新选对 Completion 模式（
Chat或Completion）再保存。 - n8n 的凭据按工作流作用域存储。多环境部署时建议各自建独立凭据，避免生产 / 开发 Key 混用。
- 两个工具默认按 OpenAI tool-calling schema 处理工具节点；在 Claude 模型上跑工具节点时，检查函数 schema 不要依赖 OpenAI 独有字段。