
One-API
国内最流行的开源 LLM 网关——Go + Docker 一键起,30+ 厂商统一 OpenAI 格式,中文 UI + 充值系统
国内开发者自建 LLM 网关首选——中文 UI + 国内模型全 + EPay 支付。海外团队 / 多语言客户端 / 微服务架构走 LiteLLM;面向中国境内公众提供服务需依法备案。
TL;DR
One-API 是国内最流行的开源 LLM API 网关——JustSong 用 Go 写的 OpenAI 兼容代理,GitHub 18K+ Star,docker run 一行起一个能用的 AI API 平台。30+ 厂商(海外 + 国内全覆盖)统一 OpenAI 格式,内置中文 UI + Key 管理 + 渠道分组 + 负载均衡 + 额度系统 + 邀请返佣。衍生项目 new-api(QuantumNous)增强多租户、缓存独立计费、内置 EPay / Stripe 支付、Claude / Gemini 原生格式、多种登录方式——已成为商业化中转站的事实底座。
适合:国内个人 / 小团队自建 LLM 网关 + 多账号轮询;企业内部统一多厂商 API 入口 + 中文运营;学习 LLM 网关架构。不适合:微服务架构 / 多语言客户端(走 LiteLLM);不想运维(走 OpenRouter / Portkey);向中国境内公众提供未备案服务(违法)。
核心能力
- 30+ 厂商:OpenAI / Claude / Gemini / Mistral / Groq / xAI;DeepSeek / 通义 / 文心 / 讯飞 / 智谱 / 豆包 / Moonshot / 百川 / MiniMax / 零一万物 / 阶跃星辰;Ollama / Cloudflare Workers AI 等
- Key 管理:生成 / 分发 / 过期 / 额度控制
- 渠道分组:批量创建 / 分组 / 模型映射
- 负载均衡:多 Key 轮询 + 失败自动重试
- 额度系统:用户额度 / 兑换码 / 邀请返佣
- 日志监控:请求日志 / 额度明细 / 报警
- 权限控制:IP 白名单 / Token 分组 / 模型限制
- 多输出格式:OpenAI / Claude / Gemini 原生(new-api)
- 多登录方式:邮箱 / GitHub / 飞书;new-api 加 Discord / Telegram / LinuxDO / OIDC
- Docker 一键部署:SQLite(小规模)/ MySQL(生产)
- 多语言 UI:中文 / 英文 / 日文
价格
- MIT 开源免费,自托管成本 = 1 台 VPS(最小 1 核 1G 跑 SQLite 版)
- 上游模型成本走各厂商直接结算
- new-api 内置 EPay / Stripe 支付,可对接支付宝当面付 / 微信支付(自行二开)
部署起步:阿里云 / 腾讯云轻量 1 核 1G 月 ¥30,配 Cloudflare CDN 全套月不到 ¥50。
实测(5 人创业团队 + 内部统一 API 入口)
亮点:
docker run一行 5 分钟拉起 + 中文 UI 上手 0 摩擦- 多 Key 轮询解决 OpenAI / Anthropic 单 Key 限流
- 国内模型全 + 统一 OpenAI 接口,业务代码 0 修改切换
- 额度系统给每人发 token,成本归因清晰
- new-api 仪表盘 + 缓存计费让 prompt caching 优化看得见
- new-api 内置 EPay 支付对 B2B 中转站很方便
- 二次开发简单:Go 单仓 + 前端 React,加渠道 / 改 logo 都不难
踩坑:
- 默认账号 root / 123456 不改是大坑,公网暴露 = 资产被滥用
- SQLite 版只适合个人 / <10 用户,团队 / 生产必须 MySQL
- 文档以中文 README 为主,国际化弱
- 原版 one-api 缺多租户 + 缓存计费 + 仪表盘,生产几乎都得切 new-api
- 上游模型轮询时单点失败重试策略不如 LiteLLM 三类 fallback 细
- 高并发场景需要 Redis 配合做限流
- 部分上游厂商接口变更后需手动跟进升级
- 合规:未备案对外服务面临监管风险,企业内部用没问题
上手(new-api 推荐)
# MySQL 生产版
docker run --name new-api -d --restart always -p 3000:3000 \
-e SQL_DSN="root:pass@tcp(host:3306)/newapi" \
-e TZ=Asia/Shanghai \
-v $PWD/data:/data \
calciumion/new-api:latest
# 访问 http://localhost:3000
# 1. 改 root 密码 + 关注册 + 加 IP 白名单
# 2. 渠道管理 → 添加上游(OpenAI / Anthropic / DeepSeek Key)
# 3. 设模型映射 + 倍率
# 4. 用户管理 → 生成 token 给业务方
# 5. 业务方调用:
# baseURL = https://your-domain/v1
# api_key = sk-xxx-from-newapi
对比
| 维度 | One-API | new-api | LiteLLM | OpenRouter |
|---|---|---|---|---|
| 语言 | Go | Go | Python | – |
| 多租户 | ❌ | ✅ | ✅ (Enterprise) | ❌ |
| 缓存独立计费 | ❌ | ✅ | – | – |
| 内置支付 | ❌ | EPay / Stripe | ❌ | ❌(卡 + USDC) |
| 中文支付二开 | ✅ 易 | ✅ 易 | – | – |
| 中文 UI | ✅ | ✅ | 英文 | 英文 |
| 国内模型覆盖 | ✅ 全 | ✅ 全 | 部分 | 中等 |
| Claude 原生格式 | ❌ | ✅ | ✅ | OpenAI 兼容 |
| GitHub Star | 18K+ | 增长快 | 高 | – |
| 部署难度 | ⭐ | ⭐ | ⭐⭐ | – |
避坑
- 第一件事改 root 密码 + 关公开注册 + 加 IP 白名单
- 生产用 MySQL 不要 SQLite:SQLite 并发上千就吃力
- 加 Cloudflare CDN + WAF:上游厂商风控会按出口 IP,扛不住会被拉黑
- 渠道倍率别贪 0.1:太低用户烧得快 + 上游被你做穿
- 充值流水必须留痕:EPay / 自二开支付要符合发票 / 反洗钱要求
- 算法备案:对中国境内公众提供生成式 AI 服务必须备案,否则违法
- 上游条款:OpenAI / Anthropic / 国内厂商基本都禁止未授权转售 API,自用 OK,商业化要拿合作授权
- 缓存计费 (new-api):开 prompt caching 后单价不同,账单要看明细
- 国内访问外网模型:服务器要部署在能直连厂商的节点(如香港 / 美西)+ 反向代理给国内用户
适合 / 不适合
- ✅ 国内个人 / 小团队自建 LLM 网关
- ✅ 企业内部统一多厂商 API 入口
- ✅ 学习 LLM 网关架构 / 二次开发
- ✅ 国内模型 + 海外模型混用
- ✅ 中文运营 + 国内支付
- ❌ 微服务 / 多语言客户端(走 LiteLLM)
- ❌ 不想运维(走 OpenRouter / Portkey)
- ❌ 向中国境内公众提供未备案服务(违法)
- ❌ 国际化产品 / 多语言文档需求
相关阅读
来源
- CSDN — One-API vs New-API 2026 选型与部署踩坑 https://blog.csdn.net/ofoxcoding/article/details/158886435
- DeepSeek 社区 — 2026 LLM API 中转站技术全景(含 new-api 增强能力对比表)https://devpress.csdn.net/v1/article/detail/161060038
- GitHub — songquanpeng/one-api https://github.com/songquanpeng/one-api
- GitHub — QuantumNous/new-api https://github.com/QuantumNous/new-api
| 计划 | 价格 | 限制 | 国内支付 | 备注 |
|---|---|---|---|---|
| one-api(原版) | $0(MIT) | — | — | |
| new-api(增强版) | $0 | — | — |
One-API 和 new-api 怎么选?
个人 / 小团队内部用:one-api 已够。要做面向 B2B / 商业化 / 中文支付:new-api 多租户 + EPay/Stripe + 缓存独立计费 + 仪表盘更专业。new-api 是 one-api 二次开发版本,在生产场景已经全面超越原版。
支持哪些模型?
海外:OpenAI / Anthropic Claude / Google Gemini / Mistral / Groq / Cohere / xAI。国内:DeepSeek / 通义千问 / 文心一言 / 讯飞星火 / ChatGLM / 豆包 / 腾讯混元 / 360 智脑 / Moonshot / 百川 / MiniMax / 零一万物 / 阶跃星辰。本地:Ollama / Cloudflare Workers AI。
默认密码记得改
Docker 拉起后默认账号 root / 密码 123456。官方 README 已经反复警告但大量公开暴露的中转站连这一步都没做——上线前第一件事改密码 + 关注册 + 加 IP 白名单。
搭建中转站合规吗?
one-api / new-api 本身是中立技术工具,合法场景:(1) 企业内部统一管理多厂商 API;(2) 个人学习研究;(3) 与上游签订正式合作的 B2B 服务。向中国境内公众提供生成式 AI 服务,依据《生成式人工智能服务管理暂行办法》必须完成算法备案 + 内容安全责任 + 投诉举报机制。未授权代理 / 转售 OpenAI / Anthropic API 违反上游条款。