New- API
New-API是一款基于One API二次开发的开源AI大模型网关，统一聚合OpenAI、Claude、Gemini、DeepSeek等主流模型接口，支持Docker部署、协议转换、智能路由、按量计费与多租…
🚀 访问官网 0 📱 手机查看 New-API 是什么
New-API 是一款面向合法授权场景的 AI API 网关与用量管理系统，在 One API 基础上二次开发而成，采用 AGPLv3 开源协议。它的核心作用是：将分散在不同厂商的 AI 模型服务（OpenAI、Claude、Gemini、DeepSeek 等）聚合到一个统一的 OpenAI 兼容接口之下，让开发者用一套调用方式访问所有模型。
与原始 One API 相比，New-API 在接口格式支持、计费灵活性、管理界面和部署体验上有明显提升。它新增了 Claude Messages 和 Google Gemini 原生格式互转能力——你既可以用 OpenAI 格式调用 Claude 模型，也可以用 Claude 格式调用第三方模型。计费方面支持按量、按次、缓存命中折扣等多种模式，并集成了易支付和 Stripe 在线充值。
New-API 默认面向 自用、团队内部和企业私有化部署 场景，不适合对外运营未备案的生成式 AI 服务。它兼容原版 One API 的数据库，从 One API 迁移时无需重建数据。
△ New-API——统一聚合多模型，开源私有化部署的 AI 接口网关
🔗 官网：ai.haokupifa.com | 📖 文档：docs.newapi.pro
New-API 主要功能
🔌 统一接口与多格式互转
在合法授权的上游账号范围内，提供统一的 OpenAI 兼容 API 入口。同时支持 Claude Messages、Google Gemini、OpenAI Responses 三种格式的请求转换——用 OpenAI 格式调用 Claude，或用 Claude 格式调用第三方模型。新增 Rerank、Realtime API、Embeddings 等接口支持。
🔀 智能路由与故障切换
支持多渠道 加权随机分发、失败自动重试 和 故障渠道自动禁用。当一个上游渠道不可用时，系统自动切换至其他可用渠道，保障服务连续性。
💰 灵活计费体系
支持 按量计费、按次计费、缓存命中折扣 三种模式。缓存计费开启后，缓存命中的请求可按设定比例（如 50%）计费，有效降低高频重复调用的成本。配额单位换算：1 USD = 500,000 quota。
👥 多租户与权限管控
支持令牌分组、模型访问限制、用户分组倍率差异化定价。企业可对不同部门或客户设置独立的令牌和成本策略，实现组织内成本分摊。
📊 数据看板与审计
提供实时数据看板，展示账户数据、使用统计、资源消耗和性能情况。支持 API 调用审计，追踪每一次请求的去向和消耗。
🔑 多渠道登录集成
支持 GitHub、LinuxDO、Telegram、Discord、OIDC、微信、邮箱等多种登录方式。
适合人群
New-API 价格方案
软件免费 · 适合个人自用、快速验证 · 成本仅为服务器 + 上游 API 调用费
软件免费 · 适合团队内部、生产环境 · 成本为服务器 + 数据库 + 上游 API 调用费
软件免费 · 适合多节点、对外服务 · 成本为多服务器 + Redis + PG + 上游 API 调用费
💡 New-API 采用 AGPLv3 开源协议，软件本身不收取任何许可费用，用户自行承担服务器基础设施和上游模型 API 调用成本。生产环境推荐使用 Docker Compose + PostgreSQL 组合，SQLite 仅适合本地体验和临时测试。华为云提供社区单机版和 CCE 容器高可用版一键部署方案，可简化运维。
✅ 优点
- 多格式互转能力强：支持 OpenAI、Claude Messages、Gemini 三种格式互转，用一套接口灵活调用不同厂商模型，降低代码维护成本。
- 计费体系灵活：支持按量、按次、缓存命中折扣三种模式，缓存计费可按比例折扣，有效降低高频重复调用成本。
- 兼容 One API 数据库：从 One API 迁移无需重建数据，降低迁移成本。华为云已将其纳入官方部署方案，项目成熟度获认可。
- 完全免费开源：AGPLv3 协议，无许可费用。支持 Docker、宝塔面板等多种部署方式，上手门槛低。
⚠️ 注意事项
- 渠道自动测试问题：测试硬编码为非流式，导致强制流式的渠道（如部分 Codex/Azure 接口）测试失败，可能影响自动启用和重试逻辑。
- 流式断连计费缺失：流式请求客户端断连后，系统可能提前停止读取上游响应，导致 usage 数据丢失、计费缺失，生产环境需关注修复进展。
- 默认密码安全隐患：官方 docker-compose.yml 默认数据库密码为 123456，上公网前必须修改。多机部署必须设置 SESSION_SECRET 和 CRYPTO_SECRET。
- 协议合规约束：AGPLv3 含第 7 节附加署名条款，修改后通过网络向用户提供服务时须保留指定署名和原项目链接。不得对中国地区公众提供未经备案的生成式 AI 服务。
📖 使用教程
1
获取项目与部署
克隆仓库或使用官方 Docker 镜像。推荐 Docker Compose 方式，默认使用 PostgreSQL + Redis 组合，端口映射 3000:3000，数据卷 ./data:/data。宝塔面板用户可直接在应用商店搜索“New-API”一键安装。
2
初始化与配置
访问 http://服务器IP:3000 进入初始化页面，设置管理员账号密码，选择使用模式（自用/对外运营/演示）。首次部署前务必修改默认密码，并生成随机的 SESSION_SECRET 和 CRYPTO_SECRET 环境变量。
3
添加渠道与模型
在“渠道管理”中添加上游 AI 服务商的 API Key 和 Base URL。系统会自动获取该渠道支持的模型列表。配置渠道的权重、优先级和分组。
4
创建令牌并接入应用
在“API 令牌”界面创建访问令牌，格式兼容 OpenAI 规范，可直接替换第三方 AI 应用的 BASE URL 使用。
常见问题
Q：New-API 免费吗？
A：完全免费。采用 AGPLv3 开源协议，软件本身不收取任何许可费用，用户自行承担服务器基础设施和上游模型 API 调用成本。
Q：和 One API 是什么关系？
A：New-API 是基于 One API 二次开发的社区分支，兼容原版数据库，从 One API 迁移无需重建数据。在接口格式支持、计费灵活性、管理界面和部署体验上有明显提升。
Q：支持哪些部署方式？
A：支持 Docker Compose（推荐）、Docker 命令行、宝塔面板一键安装和二进制部署。生产环境推荐 Docker Compose + PostgreSQL 组合，SQLite 仅适合本地体验和临时测试。
Q：计费模式有哪些？
A：支持按量计费、按次计费、缓存命中折扣三种模式。配额单位换算：1 USD = 500,000 quota。缓存计费开启后，缓存命中的请求可按设定比例（如 50%）计费。
Q：部署时需要注意什么安全问题？
A：官方 docker-compose.yml 默认数据库密码为 123456，上公网前必须修改。多机部署必须设置 SESSION_SECRET，使用共享 Redis 时必须设置 CRYPTO_SECRET，否则会出现登录状态不一致或数据无法解密的问题。
相关工具推荐
选择建议：如果你需要开源、可私有化、支持多格式互转和在线计费的 AI 网关，New-API 是 One API 生态中功能最完整的社区分支。若只需要基础的中转功能且偏好 MIT 协议的宽松性，可评估 One API 原版。LiteLLM 更适合深度嵌入 Python 技术栈的团队。
✍️ NavCN 点评
New-API 是 One API 生态中进化最明显的社区分支。它在保留原版兼容性的基础上，补上了多格式互转、在线支付、现代化看板和更灵活的计费能力，AGPLv3 协议虽然对二次分发有约束，但对于自用和内部部署的用户几乎没有影响。华为云等云厂商已将其纳入官方部署方案，侧面说明项目的成熟度获得了认可。需要注意的两点：流式渠道测试和断连计费的已知问题在生产环境部署前应关注修复状态；默认密码不修改就上公网是明确的踩坑点。总体而言，如果你正在寻找一款能统一管理多模型 API、兼顾成本管控和团队协作的开源网关，New-API 值得认真评估。
