前言给 AI 工具配置自定义 API 这件事我最近半年做了不下十次LobeChat 给家人用、Dify 搭工作流、Open WebUI 部署在公司内网、NextChat 给朋友装、Cherry Studio 装在自己电脑上……每换一个 API 来源就要把所有工具重配一遍而每个工具的配置项叫法不一、URL 规则不一——LobeChat 要带 /v1NextChat 不能带 /v1Dify 用根路径还得选对供应商类型。每次都要踩一遍坑。烦透了我把全部配置整理成了一个开源仓库awesome-ai-gateway-configs本文是它的导读 背后的踩坑知识浓缩。GitHubhttps://github.com/houbanye4/awesome-ai-gateway-configs一、先记住万能公式所有工具的配置都是这三个参数的排列组合API 地址 (base_url) 网关地址如 https://api.rqu.cn/v1 API 密钥 (api_key) sk-开头的密钥 模型名 (model) 网关支持的模型 ID精确匹配我的 API 来源用的是 Rqu AI 聚合网关——一个 Key 后面挂 GPT / Claude / Gemini / DeepSeek / 通义全家桶。这意味着十几个工具共用同一个 Key换模型只是改个名字再也不用在每家官网分别注册充值了。二、五个工具的配置差异最容易踩的坑LobeChat带 /v1设置 → 语言模型 → OpenAI 供应商 → API Proxy Address 填https://api.rqu.cn/v1。记得手动把要用的模型 ID 加进模型列表否则切换时报错。NextChatChatGPT-Next-Web不带 /v1接口地址填https://api.rqu.cn根路径它会自动补。这是全部工具里唯一反着来的我第一次配置在这里卡了十分钟。Open WebUI带 /v1走管理员面板管理员面板 → 设置 → 外部连接 → 添加 OpenAI 连接。保存后自动拉取模型列表体验最顺。Dify用 OpenAI-API-compatible 供应商两个坑一是别选 “OpenAI” 供应商会强制走官方域名要选OpenAI-API-compatible二是 URL 填根路径不带 /v1。每个模型要单独添加一条。桌面客户端Cherry Studio / ChatBoxCherry Studio 要完整带 /v1ChatBox 填根路径自动补。同一对工具规则相反——所以我把全部差异做成了速查表。三、为什么我建议所有工具共用一个网关配完这一圈之后的效果是一个 Key 管所有工具——余额、用量在一个后台看全貌不用挨个查换模型即换体验——今天想用 Claude 写东西、明天用 DeepSeek 跑批量工具侧只改模型名失效风险集中管理——上游渠道出问题网关层自动切备用源十几个工具无感知成本统一核算——家庭用量、工作用量、实验用量建三个 Key 就能分开记账。反过来如果每个工具各自注册厂商账号账号管理、付款方式、用量监控都是 ×N 的工作量。四、开源仓库里有什么awesome-ai-gateway-configsMIT持续更新8 个工具的完整接入配置OpenAI SDKPython/JS、LangChain、LlamaIndex、LobeChat、NextChat、Open WebUI、Dify、Cherry Studio/ChatBox每个文档都包含网页界面配置 Docker 环境变量配置 该工具特有的坑万能公式与排查清单报 401 查什么、报 404 先查什么PR 欢迎新工具的配置、版本更新导致的差异修正都是高质量贡献。五、通用排查清单任何工具接入失败时按序查401→ Key 复制带了空格/引号重贴一次404→ 90% 是 base_url 的/v1问题按上面对照表改模型不存在→ 模型 ID 必须精确匹配网关列表去模型广场抄能通但乱码/空回复→ 检查该工具是否用了 completion 而非 chat 接口LlamaIndex 记得is_chat_modelTrue突然全部失效→ 先用 curl 直接打网关/v1/models分离问题是工具坏了还是端点挂了。六、结语工具链统一到一个 OpenAI 兼容端点之后我的 AI 工具箱第一次有了基础设施的感觉底层是网关上层随便换工具、换模型互不影响。仓库地址https://github.com/houbanye4/awesome-ai-gateway-configs点个 Star 就是最大鼓励相关系列《聚合网关接入实践》《成本优化 5 策略》《开源浏览器智能体》都在我博客首页。