教程
Cline / Dify / n8n 如何配置 OpenAI-compatible Base URL,以及为什么要用虚拟 Key
很多 AI 工具都支持 OpenAI-compatible 接入方式。看起来只是填写 Base URL、API Key 和 Model, 但真实使用时,更重要的是预算控制、密钥隔离和出问题时能否快速止损。
哪些工具适合这种配置
常见工具包括:
- Cline / Continue
- Dify
- n8n
- Chatbox
- Open WebUI
- LangChain / LlamaIndex 小脚本
它们通常会要求填写:
Base URL API Key Model
主 API Key 不适合到处填
很多人一开始会把供应商主 API Key 直接填进各种工具。短期看方便,长期看风险比较大:
- 一个工具泄露,主 Key 就可能泄露。
- 不同项目共用一个 Key,很难判断是谁在消耗额度。
- 临时给别人测试时,不方便随时停用。
- 如果某个工作流失控,可能直接消耗主账户余额。
更稳的做法是:不要把主供应商 Key 到处复制,而是给不同工具或项目分配不同虚拟 Key。
为什么要用虚拟 Key
虚拟 Key 的价值不是“换个字符串”,而是它背后的控制能力:
- 每个工具一个 Key。
- 每个项目一个 Key。
- 可以设置预算上限。
- 可以设置过期时间。
- 可以限制模型白名单。
- 可以随时停用。
- 可以只看必要用量,不把敏感提示词当卖点。
常见 OpenAI-compatible 配置
大多数工具里可以按这个思路填:
Base URL: https://example.com/v1 API Key: 你的虚拟 Key Model: 网关里允许的模型名
第一次不要直接跑大任务,先用一个 smoke test:
Reply exactly: customer-ok
如果返回:
customer-ok
说明最基本的连通性是 OK 的。
ModelRouteJP 小范围测试
ModelRouteJP 是一个小额度 AI API 网关,面向 Cline / Dify / n8n / Chatbox 这类工具用户。 它不是无限量中转站,也不承诺绕过任何限制;当前重点是验证小额度虚拟 Key、预算上限、过期时间和模型白名单是否有实际价值。
Base URL: https://api.modelroutejp.com/v1 Model: openai-gpt-4o-mini
默认测试 Key 会设置:
- 小额度预算。
- 短期过期。
- RPM / TPM 限制。
- 模型白名单。
- 不建议传敏感数据。
如果你刚好在用 Cline、Dify、n8n、Chatbox、Open WebUI 或类似工具,并且愿意帮忙测一下配置体验, 可以发邮件到 hello@modelroutejp.com。
邮件标题: Seed test key request
总结
如果只是偶尔测试,直接填一个 Key 也许够用。但如果你已经把 Cline / Dify / n8n 用在真实项目里, 更建议尽早把主 Key 和工具 Key 分开。
一个 OpenAI-compatible Base URL 多个虚拟 Key 每个 Key 有预算、过期时间、模型白名单