2026 自建聚合大模型网关实战教程：NewAPI 从零部署到客户端接入全流程

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