想在同一个入口里调用多家大模型,又不依赖别人搭好的服务,基于 NewAPI 自建聚合网关是开发圈里常见的做法。NewAPI 是 One-API 的活跃分支,开源免费、兼容 OpenAI 接口格式,既能当个人统一入口,也能做多团队的分发系统。本篇按从零部署到客户端接入的顺序,把完整流程过一遍。
NewAPI 的定位与核心能力
NewAPI 是一套开源的大模型 API 网关与分发系统,设计目标就是把多家大模型厂商聚合到统一入口。相比老牌的 One-API,它前端界面更现代化、迭代更活跃,上手体验要好不少。核心能力覆盖统一渠道管理、令牌分发、计费倍率、用量日志、额度控制与多用户支持,个人和团队都能直接拿来用。
两种使用形态:公共聚合站与自建服务
它的使用形态有两种,别混淆。第一种是公共 NewAPI 聚合站:由别人部署好,你注册充值就能使用,零部署、上手最快。第二种是自建服务:在自己服务器上用 Docker 跑起来,渠道与密钥完全自己掌控,适合有定制需求的开发者与团队。下面的内容两种形态都会讲到。
方式一:使用公共聚合站,零部署最快上手
操作路径很简单:打开站点,用邮箱或手机号注册,在令牌页生成一把 API Key,查看模型价格与支持列表,按量充值(通常有优惠),最后在客户端里替换 Base URL 和 Key 就完成接入。
常见客户端的配置思路也一致:通用 OpenAI 兼容客户端把 Base URL 填成聚合站地址加 /v1,Key 填令牌即可;Claude Code、Cursor、ChatBox 这类支持自定义接口的工具,同样只需要改 Base URL 和 Key 两处。使用前建议先到模型页确认目标模型名是否支持,避免出现 404 或路由失败。
方式二:在自有服务器上部署
自建的主流做法是 Docker 或 Docker Compose 一键部署:拉起容器、映射 Web 端口、挂载数据卷,几条命令就能跑起来。用默认管理员账号登录后第一件事是改密码,然后到后台添加渠道——填入各厂商的 API Key、选择渠道类型、配置模型列表,再创建令牌发给客户端。
进阶玩法包括:配置模型倍率与分组倍率,实现差价管理;开启负载均衡,把同一模型挂到多个渠道互为备份;并发上来之后用 MySQL 替换默认的 SQLite,让数据库扛得住压力。
聚合站的运营逻辑与自建的取舍
从运营角度看,聚合站站长通常以较低价格批量采购上游额度(官方或云厂商),再加价或按倍率卖给站内用户,靠差价维持服务运转。自建的好处是没有中间商差价、数据自己掌控,代价是服务器成本与日常运维都要自己扛。
安全与运维注意事项
聚合分发本质涉及第三方转售,账号与数据合规需要自己把关,敏感数据不建议放到公共站点上处理。公共站适合快速尝鲜与轻度使用,生产环境或重度使用建议自建,稳定可控。部署完成后,推荐配置 HTTPS(Nginx 反向代理加证书),并定期备份数据库。
自建之外:直接接入聚合平台省去运维
如果看完整个流程后觉得运维负担偏重,还有一条更省心的路:直接接入词元之河(TokenRiver.ai) 这类聚合平台。它聚合了 OpenAI、Claude、Gemini、DeepSeek 等主流模型,提供统一的 API 接入,改一个 Base URL 就能开始调用,服务器、证书、渠道维护这些事全部交给平台。它还支持子账号分权、用量监控与 Token 级账单,可开对公发票,提供 SLA 保障;国内直连,新模型上架快。对不想养运维、又需要企业级能力闭环的团队,这是比自建网关更划算的选项。