One API部署教程：一键聚合OpenAI/DeepSeek等多家大模型API

最近跟几个做AI开发的朋友聊天，发现大家都有一个共同的痛点——手头同时用着OpenAI、Gemini、DeepSeek好几家的API，每个平台都要单独注册、单独充值、单独管理密钥。项目一多，光是Key的管理就够让人崩溃的。今天想跟你聊一个开源项目，叫One API，据说能把这个问题一站式解决。 对，One API这个项目在GitHub上其实已经挺活跃了。它的核心思路说白了特别简单——就是把多家大模型服务商的API统一接入到一个平台里。你部署好之后，只需要一个API Key，就能调用平台上配置好的所有模型。GPT系列、Gemini、DeepSeek、Claude，全都能用。 这听起来有点像微服务架构里的API网关？ 没错，你这个类比非常准确。它本质上就是一个面向大语言模型的API Gateway。你想啊，2024年以来全球主流AI服务商超过20家了，每家的接口规范、计费体系、认证机制都不一样。One API做的事情就是把这些差异全部屏蔽在网关内部，对外只暴露一套统一的调用接口。就好比你家装了个万能遥控器，不管电视是什么牌子的，按同一个按钮就能开。 那它适合什么样的人用呢？我感觉个人开发者肯定是一类。 个人开发者是最直接的受益者，不用在不同项目里来回切换Key了。但其实还有两类人特别适合。一类是技术团队，它有一套令牌系统，可以给团队成员分配不同的调用权限，还能控制额度和有效期。另一类是做商业运营的，批量采购各平台API后统一转售。你现在市面上看到的不少API中转站，底层就是拿One API搭的。 嗯，那我们聊聊部署吧。很多人一听到要自己部署服务，第一反应就是——这会不会很复杂？ 其实真不复杂。你需要准备的东西很简单：一台VPS，1核1G内存就够了，One API本身非常轻量；然后一个域名，通过Cloudflare做DNS解析；再加一个SSH客户端，比如FinalShell。硬件成本很低，市面上最便宜的VPS一个月也就几十块钱。 域名解析这块有什么需要注意的吗？ 有一个小坑要提醒一下。在Cloudflare里添加A记录的时候，一定要把代理状态关掉，就是让那个小云朵变成灰色。因为后面我们要用Nginx Proxy Manager自己申请SSL证书，如果Cloudflare的代理开着，证书申请时的域名验证可能会被干扰。等全部配好之后，你再根据需要把CDN代理打开也行。 说到Nginx Proxy Manager，这个工具在整个部署里扮演什么角色？为什么不直接用One API自带的方式？ 好问题。NPM在这里做的是反向代理，就是把用户通过域名发起的HTTPS请求自动转发到One API运行的3000端口。同时它还提供SSL加密保护，确保API Key这些敏感信息在传输过程中不被窃取。它内置了Let's Encrypt的自动证书管理，免费申请、自动续期，你完全不用操心证书过期的问题。而且它有图形化界面，点点鼠标就能配好，比手写Nginx配置文件友好太多了。 所以整个部署流程大概是：先做域名解析，然后SSH连上服务器放行端口，接着装NPM做反向代理，最后用Docker把One API拉起来？ 对，就这四步。端口方面需要放行80、443给NPM的HTTP和HTTPS流量，81是NPM的管理面板，3000是One API的默认端口。Docker部署的好处在于你不需要手动装Go语言环境和各种依赖库，一条命令拉镜像启动服务就完事了。整个流程顺利的话，半小时之内就能搞定。 部署完之后，具体怎么用呢？比如我想把DeepSeek接进来。 One API里有两个核心概念，一个叫渠道，一个叫令牌。渠道就是对应各家服务商的API接入配置。拿DeepSeek举例，你在渠道页面点添加，类型选DeepSeek，勾选你要用的模型比如deepseek-chat，然后去DeepSeek开放平台创建一个API Key粘贴进来，提交就行了。添加完点测试按钮验证一下能不能调通。用同样的方法把OpenAI、Gemini、Claude全加进来。 渠道系统还有什么高级玩法吗？ 有的，这也是One API比较厉害的地方。它支持优先级调度和故障转移。比如你给同一个模型配了多个渠道，可以设置权重，系统会做加权随机分配实现负载均衡。某个渠道挂了——比如余额不足或者被限速了——系统会自动把请求重试到其他可用渠道，调用方完全无感知。还有一个模型映射功能特别实用，你可以把gpt-4的请求在OpenAI额度用完后自动路由到Claude或DeepSeek的对应模型上。 这个故障转移机制确实很关键，特别是做商业运营的话，服务不能断。那令牌这块呢？ 令牌本质上是API密钥的二级分发机制。渠道里配的是各服务商的原始Key，这是主密钥，永远不会暴露给终端用户。你对外分发的是One API自己生成的派生密钥。每个令牌可以独立设置调用额度、有效期、可用模型范围，甚至IP白名单。某个令牌泄露了，你单独禁用它就行，不影响其他人。在商业场景里，这套机制就相当于一个轻量级的API计费和权限管理系统。 那生成的这个令牌，在客户端怎么用呢？ 这里有个很巧妙的设计。OpenAI的Chat Completions API现在已经成了大模型API的事实标准，几乎所有主流服务商都提供了兼容格式。One API做的核心工作之一就是把不同服务商的原生格式统一转换成OpenAI兼容格式。所以任何支持OpenAI API的客户端工具——Cline、ChatGPT-Next-Web、LobeChat、Cursor——都可以直接对接，只需要把API地址改成你的域名加上/v1，Key填你生成的令牌，就完事了。 最后聊聊运营层面的事。如果有人想拿这个做点商业化，你有什么建议？ 几个关键点。第一，一定要算清成本，各平台API的实际单价差异不小，比如GPT-4o通过OpenAI官方和通过Azure渠道获取的价格可能差很多。第二，令牌的额度限制和过期时间一定要用起来，防止被恶意刷量。第三，同一个模型建议配多个渠道做冗余。第四，安全方面，默认密码必须改，Docker镜像要定期更新，建议开启日志监控异常调用。还有一点特别重要——各AI服务商对API转售都有自己的条款，特别是OpenAI明确要求不得用API构建竞争性产品，转售行为一定要仔细看条款，确认合规。 嗯，合规这个确实容易被忽略。总结一下的话，One API就是用一台轻量VPS加一个域名，花半小时就能搭起来的大模型API聚合网关。不管是自己开发省心，还是搭平台做点小生意，都是一个挺实用的开源方案。 对，而且它的学习成本真的很低。你不需要懂太多运维知识，Docker加NPM的组合基本上把复杂度都抹平了。有兴趣的朋友可以直接去GitHub上搜One API，文档也比较齐全，动手试试就知道了。