One API、New API 都是常见的开源 AI API 网关项目,可以把多家模型供应商收口成一个 OpenAI 兼容接口。很多团队在用量变大后,会考虑“自己搭一个”还是“直接用托管服务”。

本文讲清楚两者的区别、自建需要什么、什么时候适合自建,以及怎么迁移。

说明:One API、New API 均为其项目/权利人的名称。本文仅用于技术讨论,具体功能和许可以项目仓库为准。

一、One API / New API 是什么

它们本质上是 API 网关:

你的应用 → 网关(Key/额度/路由/日志)→ OpenAI / Claude / Gemini / DeepSeek

常见能力:

  • OpenAI 兼容接口。
  • 多渠道/多模型管理。
  • 用户、令牌、额度、分组。
  • 用量日志和计费。
  • 限流、重试、渠道切换。
  • 管理后台。

One API 出现较早,New API 是在其生态上继续发展的项目之一,功能和管理界面更现代。两者都适合有一定技术能力的团队自建。

二、自建需要什么

1. 服务器

一台能跑 Docker 的 Linux 服务器。配置取决于并发和日志量;小团队起步不需要很高配置,但要考虑带宽和磁盘。

2. 数据库

常见选择:SQLite(简单)、MySQL、PostgreSQL。生产环境建议 MySQL/PostgreSQL,并做好备份。

3. Redis(可选但推荐)

用于缓存、会话、限流等。多节点部署时更需要。

4. 域名和 HTTPS

需要域名、DNS、反向代理(Caddy/Nginx)和证书。支付回调和 OAuth 登录都要求公网 HTTPS。

5. 上游账号/渠道

你需要自己准备 OpenAI、Claude、Gemini、DeepSeek 等上游 Key 或渠道。网关本身不提供模型额度。

6. 运维

包括:升级、备份、监控、日志、漏洞修复、支付对账、异常告警。这些是自建的主要隐性成本。

三、自建 vs 托管

维度 自建 One API/New API 托管服务(如中商起航)
初始成本 服务器 + 域名 + 时间 注册即用
数据控制 高,数据在自己服务器 取决于服务商条款
模型渠道 自己申请/维护 平台提供
运维 自己负责 平台负责
升级/安全 自己跟进 平台跟进
支付/发票 自己处理 平台处理
定制 高 受平台功能限制
适合谁 有技术团队、要深度定制 想快速上线、少运维

四、自建的大致步骤

1. 准备服务器和域名

安装 Docker,解析域名,配置防火墙。只开放 22/80/443,数据库和 Redis 不暴露公网。

2. 部署数据库和 Redis

使用强随机密码,配置持久化卷和每日备份。

3. 部署网关

用 Docker Compose 启动应用、数据库、Redis。配置环境变量:

  • 数据库连接。
  • Redis 连接。
  • 会话密钥。
  • 站点地址。
  • CORS/可信域名。

4. 配置反向代理和 HTTPS

Caddy/Nginx 反代到应用端口,开启 HTTPS/HSTS。

5. 配置上游渠道

在后台添加渠道、模型、分组、倍率。先用一个小额 Key 跑通。

6. 配置支付/OAuth(可选)

支付回调、Google/GitHub 登录都需要公网 HTTPS 和正确的回调地址。

7. 监控和备份

至少做:可用性监控、错误日志、数据库备份、磁盘告警。

五、什么时候适合自建

  • 有技术团队,能处理服务器和升级。
  • 数据必须留在自己服务器。
  • 需要深度定制路由、计费、权限。
  • 上游渠道稳定,自己有能力维护。
  • 用量大,托管费用明显高于自建总成本。

六、什么时候不适合自建

  • 没有运维人手。
  • 只想快速上线验证产品。
  • 上游账号/支付/合规搞不定。
  • 无法保证安全更新和备份。
  • 把“省一点 API 费”当作主要目标。

自建不是免费的:服务器、域名、证书、备份、监控、排障和安全更新都要算钱。

七、迁移到托管服务的步骤

如果你已经自建,但想换成托管:

  1. 导出用户/令牌/渠道配置(只用于盘点,不要泄露 Key)。
  2. 在托管平台创建账号和 Key。
  3. 把 Base URL 改为托管地址。
  4. 做模型映射。
  5. 小流量灰度 3–7 天。
  6. 保留自建实例作为备用,稳定后再下线。

八、常见问题

New API 和 One API 哪个好?

取决于你的需求、版本和维护能力。建议看项目活跃度、文档、许可、社区和你的技术栈,不要只看功能列表。

自建网关能直接用官方模型吗?

可以,但你需要自己准备上游 Key/渠道,并遵守各供应商条款。

自建需要多少钱?

服务器、域名、备份、监控和人力都是成本。小规模可能很低,但企业级要高可用、备份和安全投入。

托管服务会不会锁定?

看你是否把 Base URL/模型名做成配置。保持 OpenAI 兼容和配置化,迁移成本会低很多。

下一步

如果你不想维护服务器、数据库、支付和升级,可以先用 中商起航 AI 网关 的托管服务跑通业务;如果必须自建,按上面的清单评估人力和安全成本。模型和价格以 模型价格 为准。

相关阅读: