ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

NewAPI聚合网关搭建实战:从零部署到客户端接入教程(2026)

NewAPI聚合网关搭建实战:从零部署到客户端接入教程(2026)

NewAPI是One-API的活跃分支,一个开源的大模型API网关与分发系统,前端界面现代化、更新节奏快,核心能力覆盖统一渠道管理、令牌分发、计费倍率、用量日志、额度控制与多用户支持。想在团队里把多家模型收进一个入口,又想完全掌控渠道和密钥,自建NewAPI聚合网关是当前最主流的玩法之一。本文按准备、配置、验证、常见问题四步,走一遍从零部署到客户端接入的完整流程。

准备:选清形态并备好环境

先分清两种常见形态:一是直接用别人部署好的公共站点,注册充值即用,零部署最快上手;二是在自己服务器上跑,适合有定制需求的开发者与团队,本文以自建为主。准备一台服务器并装好Docker与Docker Compose,预留Web端口和数据卷;若预期并发较高,提前装好MySQL,用来替换默认的SQLite。

配置:部署服务与添加渠道

用Docker Compose一键拉起容器,映射端口与数据卷即完成基础部署;以默认管理员账号登录后,第一时间改掉初始密码。进后台添加「渠道」,逐家填入厂商API Key、选择渠道类型、勾选模型列表,再创建「令牌」发给客户端。进阶玩法包括配置模型倍率与分组倍率做差价管理、给同一模型挂多渠道互备实现负载均衡、用MySQL支撑更高并发。

验证:客户端改两处即可

通用OpenAI兼容客户端里,Base URL填站点地址加/v1,Key填生成的令牌;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。

返回列表