New API 干的事一句话说清：把你手上散落的 OpenAI、Claude、Gemini、通义、DeepSeek 这些接口，全部汇总到一个地址，然后给你的用户（或者你自己）发一把新钥匙，统一计费、统一看用量。
它是 one-api 的分支，GitHub 上 50091 Star，比原版还火。Go 写的，编译出来就是一个 132MB 的单文件 exe，数据库内置 SQLite。
我自己搭了一遍，从一个空 exe 到能跑通完整链路，中间撞了五个坑。下面按顺序讲，坑也标在原位。
New API 能干什么
一句话：它是 AI 接口的二道贩子，也是你自己家的收银台。
按用途对号入座——
- 一个人有好几家的 key：把 OpenAI、Claude、Gemini、DeepSeek、通义全接进来，对外只暴露一个地址、一把钥匙，换模型只改一个参数
- 小团队共用额度：每人发一个令牌，各自限额度、限模型，谁的用量超了一眼能看出来
- 对外售卖 AI 服务：带用户注册、充值、分组倍率、按量扣费，一套完整的计费闭环
- 多个上游 key 轮着用：同一个模型挂好几个渠道，一个限流了自动换下一个，用户无感
- 想让自己的工具链不改代码就换模型：它吐的是 OpenAI 兼容格式，任何支持自定义 base_url 的客户端都能直接接
它不训练模型、不代理网页版 ChatGPT，就是个纯转发 + 计费层。指望它「免费白嫖 API」的，方向就错了。
核心功能亮点
- OpenAI 兼容接口：
/v1/chat/completions这一套照搬，客户端几乎零改动 - 渠道管理：一个上游算一个渠道，同一个模型可以挂多个渠道做轮询和失败重试
- 令牌（Key）体系：给谁用、能用哪些模型、额度多少、什么时候过期，全在令牌上配
- 用户与充值：注册、分组、倍率、余额扣减，做成对外服务也能收得住钱
- 用量日志：每次调用记一条，模型、token 数、耗时、扣费都留着
- 游乐场：网页里直接选模型对话，调渠道的时候不用另开客户端
- 自带前台官网：首页、关于页、暗色模式、移动端适配都有，不是光秃秃一个后台
- 单 exe + 内置 SQLite：不用装 MySQL，解压就能跑
底子怎么样
- 版本：v1.0.0-rc.44
- 协议：AGPL-3.0——改了对外提供服务，得开源你的改动，商用前先看清楚
- 技术栈：Go，编译后单个 132MB exe
- 数据库：内置 SQLite，也能接 MySQL / PostgreSQL
- GitHub：5 万 Star，是 one-api 的分支，比原版还热
部署：一条命令，但默认端口别硬上
new-api-v1.0.0-rc.44.exe --port 3100 --log-dir ./logs默认端口是 3000，我直接用了，结果起不来。查了一下，我机器上 3000 端口已经被两个别的程序抢了——一个返回 Flask 风格 404，另一个在 ::1 上。所以这条命令里我写的是 3100，你自己部署的时候先看一眼端口。
启动大概 2 秒，exe 会在当前目录自动建两个东西：one-api.db（数据全在这）和 logs（日志）。没有依赖、没有环境变量要配、不用装数据库。
初始化向导：四步
第一次访问会跳到 /setup，是个四步向导，全中文。
第一步数据库，默认 SQLite，直接下一步。想用 MySQL 的话这里可以切：
第二步管理员账户，密码至少 8 位。这个限制是硬性的，我试过短的直接被拦：
第三步选使用模式。「对外运营」会开启充值、兑换码、用户注册这一套；个人用就选「个人使用」，界面会干净很多：
第四步确认，点初始化：
几秒钟后弹出结果页，写的挺明白——管理员账号、API 地址、控制台地址都给出来了：
登录进控制台
登录页是英文的（Sign in），用户名密码就是刚才建的那个：
进去第一眼是仪表盘，数据全是 0，因为还什么都没接：
改站名：控制台 → 系统设置 → 站点与品牌 → 信息
我习惯先把显示名改成「源码湾」，不然截图一堆 New API 看着乱。
位置在「系统设置」里的「站点与品牌」，第一栏就是「信息」。要改的是这几个：系统名称、Logo 地址、页脚、关于页内容。
注意 Logo 这里只能填 URL，没有本地上传——你得自己先把图放到服务器上，或者传到图床拿到链接再填进来。这一点跟 Halo、Typecho 那种带附件库的系统比，确实简陋：
保存后左上角立刻变：
加渠道：这一步是真麻烦
「渠道」就是上游 API。控制台里点「渠道」→「添加渠道」：
弹窗里要填的东西不多，但有三样是必填的，缺一样都不给保存：渠道名称、API 密钥、模型列表。
我一开始只填了名称和类型，点保存直接被拦，提示「请先修复高亮字段后再保存」。
密钥那一栏在下面，是个大 textarea，格式可以一行一个：
模型这块有个偷懒按钮——「填入相关模型」。你选了 OpenAI 类型，点一下它直接给你把该类型下所有模型（我记得是 123 个）全部选中，不用一个个勾：
保存之后渠道列表里会显示成这样，状态、余额、优先级都在一行里。这里提醒一句：密钥得是你自己的、真的能用的上游密钥。我用的是个测试密钥，所以「测试」按钮点了是报错的，这是正常的，不代表系统有问题。
发密钥
渠道通了之后，去「API 密钥」建一把自己的钥匙给用户用：
建的时候可以设额度、设过期时间、限定可用模型。不设额度就是无限，自己测的时候无所谓，真对外了我建议一定要设个上限，不然让人跑爆了 Friendly 提醒都没有。
用户管理页长这样，早期就你一个管理员：
游乐场
控制台里有个「游乐场」，可以在网页上直接跟模型对话，不用写代码验证：
这里能不能用，直接取决于上面渠道配的对不对。通道没通，游乐场就是个摆设。
前台：这套东西居然带官网
这个是我没想到的。New API 不只是个后台，前台还有一套完整的展示站——首页有模型价格表、有 API 文档、有关于页，看起来就像个正经的商业中转站：
关于页的内容就是后台那个「关于」字段填的：
这里踩了第五个坑：关于页我一开始填的是 HTML，结果渲染出来文字直接顶到页头，把左上角 logo 压住了。看源码发现它走的是一条特殊分支（htmlVariant='isolated' + showMainContainer={false}），HTML 模式不给主容器边距。改成 Markdown 写，就正常了。所以这个字段，建议直接写 Markdown。
前台也支持暗色，右上角按钮：
移动端适配没问题，首页和控制台都能用：
五个坑，按痛的程度排
缺点
得说几句实话，这东西不是人人都需要。
一、它本身不产生任何 AI 能力。 你得自己有上游 API 密钥——OpenAI、Claude、国内各家，一个都不能少。没密钥，装完就是个空壳，连游乐场都发不出话。很多人装完发现没用就是因为这个。
二、计费概念对小白有门槛。 倍率、模型倍率、补全倍率、分组倍率、额度换算……我花了不少时间才搞明白「额度」和「美元」怎么换算。这套定价体系是给运营者设计的，你要只是想给自己几个应用共用一把钥匙，纯属负担。
三、模型广场是空的。 官方说前台有模型价格展示，但装完进去看是空的——得先在后台给每个模型配好定价、启用展示，才会出现。等于那个「价格表」你得自己一个个填。
四、Go 编译的单文件 132MB。 好处是零依赖，坏处是每次升级都要重新下整个 exe，而且这个体积放小内存 VPS 上，启动那一刻内存会冲一下。
实测环境
- Windows 10 本地，3100 端口
- New API v1.0.0-rc.44，单 exe 132MB
SQLite 内置，无需额外数据库
项目 配置 从启动到初始化完成 约 3 分钟 许可证 AGPL-3.0
下载
我把实测用的这个版本打包好了，里面是 exe + 校验文件 + 完整源码 + 启动脚本 + 使用说明，双击 启动NewAPI.bat 就能跑：
上面记的这些坑，你自己走一遍也都会遇到。环境、依赖、配置、目录结构，一个都省不了。包里是我这边全部跑通之后才打的——要跳过这几步，直接拿下面这个。
两个小提醒：
- 建议先「转存到自己网盘」再下载——直接下载的链接容易失效，转存后就是你自己的了，随时能下；
- 手机上操作：点开链接 → 右下角「保存到网盘」→ 回夸克 App 的「我的网盘」里下载。
装之前先确认两件事：一个没被占用的端口（默认 3000，我实测用 3100）、至少一个能用的上游 API key。SQLite 内置，数据库这块不用准备。
免责声明：本项目基于 AGPL-3.0 协议开源，本站仅作收集整理与技术实测分享，不提供任何商业授权。源码版权归原作者所有。请勿将本系统用于任何违法违规用途，由此产生的一切后果由使用者自行承担。如有侵权，请联系 2273962061@qq.com 删除。
