NewAPI聚合网关搭建实战：从零部署到客户端接入教程（2026）

NewAPI是One-API的活跃分支一个开源的大模型API网关与分发系统前端界面现代化、更新节奏快核心能力覆盖统一渠道管理、令牌分发、计费倍率、用量日志、额度控制与多用户支持。想在团队里把多家模型收进一个入口又想完全掌控渠道和密钥自建NewAPI聚合网关是当前最主流的玩法之一。本文按准备、配置、验证、常见问题四步走一遍从零部署到客户端接入的完整流程。准备选清形态并备好环境先分清两种常见形态一是直接用别人部署好的公共站点注册充值即用零部署最快上手二是在自己服务器上跑适合有定制需求的开发者与团队本文以自建为主。准备一台服务器并装好Docker与Docker Compose预留Web端口和数据卷若预期并发较高提前装好MySQL用来替换默认的SQLite。配置部署服务与添加渠道用Docker Compose一键拉起容器映射端口与数据卷即完成基础部署以默认管理员账号登录后第一时间改掉初始密码。进后台添加「渠道」逐家填入厂商API Key、选择渠道类型、勾选模型列表再创建「令牌」发给客户端。进阶玩法包括配置模型倍率与分组倍率做差价管理、给同一模型挂多渠道互备实现负载均衡、用MySQL支撑更高并发。验证客户端改两处即可通用OpenAI兼容客户端里Base URL填站点地址加/v1Key填生成的令牌Claude Code、Cursor、ChatBox这类支持自定义接口的工具同样只改这两处。调用前先在「模型」页确认目标模型名在支持列表内避免404或路由失败再用小流量把流式输出与工具调用两个场景跑通。常见问题与运维建议出现404多为模型名写错或渠道未勾选该模型回到渠道配置核对即可并发上来后SQLite容易成为瓶颈切换MySQL可解上线前建议用Nginx反代配好HTTPS证书并养成定期备载数据库的习惯。总体而言公共站适合尝鲜与轻度使用生产或重度使用建议自建稳定可控。想省事直接用词元之河(TokenRiver.ai)不想承担服务器与运维成本的话可以直接用词元之河(TokenRiver.ai)聚合GPT、Claude、Gemini、DeepSeek等主流模型统一API接入一个密钥多家调用兼容OpenAI、Anthropic、Gemini三套协议Claude Code、Cursor只需换base_url与密钥即可直用。子账号分权、多成员权限、用量监控、调用日志、Token级账单、审计日志、对公发票与SLA保障条款一应俱全国内直连、多节点容灾、自动故障切换调用连续不中断新模型上架快。按量计费、不设最低消费支持支付宝与对公转账官网tokenriver.cn。