跳到主要内容
项目档案应用项目

QuantumNous/new-api 是什么?用途、安装与使用指南

New API 是一个开源的 AI 模型网关系统,可将各类大语言模型(如 OpenAI、Claude、Gemini)转换为统一兼容格式,实现模型聚合、分发、计费与多租户管理。适用于个人开发者与企业,提供 Docker 部署、多数据库支持及支付集成。本页详细介绍项目功能、安装指南与技术实现。

48,506GoStar 于 2026年3月31日2026年9月20日 更新

AI 总结

New API 是一个统一的 AI 模型网关与资产管理平台,支持将多种大语言模型(如 OpenAI、Claude、Gemini)转换为统一兼容格式,实现模型的聚合、分发、计费与多租户管理,适用于个人与企业级 AI 服务集成。

中文项目介绍

New API 定位为下一代 LLM 网关和 AI 资产管理系统,核心功能是聚合各类 AI 模型服务,并通过协议转换使其提供标准化接口(如 OpenAI 兼容格式),从而简化多模型集成复杂度。 从功能描述推断,项目主要解决不同 AI 模型 API 接口碎片化问题:各提供商使用各异的协议和认证方式,导致客户端集成困难。本平台通过统一网关集中处理请求路由、计费、配额和模型管理,避免重复开发,并支持多租户隔离。 适用场景包括:个人开发者需同时使用多个 AI 模型进行实验或应用开发;企业或团队需集中管理 AI 服务、监控使用情况、统计费用;需要将第三方模型转换为特定格式以适配现有工具链;希望自托管 AI 网关以减少云服务依赖。注意,项目声明仅用于个人学习,无稳定性保证。 技术实现上,基于 Go 语言和 Gin 框架构建模块化 Web 服务,支持 MySQL、PostgreSQL、SQLite 多种数据库,集成 Redis 缓存与内存缓存,内置并发后台任务(如频道同步、配额重置),并集成支付(Stripe、ePay)、OAuth(LinuxDo)、WebAuthn 认证及国际化(i18n)。前端静态文件嵌入二进制,提供 Docker 部署方案。

详细信息与使用说明

1. 项目定位与用途

New API 是一个开源的 AI 模型网关与资产管理平台,旨在统一管理各类大语言模型(LLM)服务。它通过将不同提供商的模型(如 OpenAI、Claude、Gemini)转换为标准化的 API 格式(如 OpenAI-compatible),使用户能够通过单一接口访问多种模型,降低集成成本。同时,系统提供模型聚合、分发、计费和监控功能,适合作为个人或企业的 AI 服务中枢,实现资产集中化管理。

2. 解决的问题

仓库中未明确给出完整的问题定义。但从功能描述推断,New API 主要解决 AI 模型接口碎片化问题:不同模型提供商使用各异的 API 协议和认证方式,导致集成复杂。本平台通过协议转换和统一网关,简化客户端调用,并集中处理计费、配额和模型管理,避免重复开发。此外,它支持多租户,满足团队或企业的资源隔离需求,但项目声明仅用于个人学习,无稳定性保证。

3. 适用场景

New API 适用于以下场景:1) 个人开发者需要同时使用多个 AI 模型(如 GPT、Claude)进行实验或应用开发,希望统一调用接口;2) 企业或团队需集中管理 AI 服务,包括模型选择、使用配额、费用统计和访问控制;3) 需要将第三方 AI 模型转换为特定兼容格式(如 OpenAI 格式)以适配现有工具链;4) 希望自托管 AI 网关,避免依赖单一云服务商。使用时必须遵守相关服务条款及法律法规。

4. 安装方式

根据 README,推荐使用 Docker Compose 部署。步骤包括:克隆仓库、复制 .env.example 为 .env 并配置环境变量(如数据库连接、Redis、端口等)、运行 docker-compose up。环境变量涵盖数据库(MySQL/PostgreSQL/SQLite)、Redis、缓存同步频率、支付配置等。但当前仓库信息中命令不完整,详细安装步骤需参考完整 README。仓库未提供其他安装方式(如二进制包或源码编译)的明确说明。

5. 使用方式

部署后,用户可通过网关 API 访问转换后的模型。具体使用方式未在仓库中明确给出。从功能推断,客户端应使用标准 OpenAI 或兼容格式的请求发送到网关地址,网关根据配置路由到对应上游模型并返回响应。系统提供管理界面(可能通过 Web 前端)进行模型、渠道和用户管理。详细 API 文档、示例或客户端 SDK 需查阅项目文档,但当前信息不足。

6. 实现特点与依赖

New API 基于 Go 语言开发,使用 Gin 框架处理 HTTP 请求,GORM 支持多数据库,Redis 用于缓存。关键依赖包括:gin-gonic/gin(Web 框架)、gorm.io/gorm(ORM)、github.com/go-redis/redis/v8(缓存)、github.com/aws/aws-sdk-go-v2(AWS 服务)、github.com/stripe/stripe-go/v81(支付)。架构上,采用控制器(controller)、服务(service)、模型(model)分层,内置并发任务调度(如频道同步、配额重置),并集成 OAuth(LinuxDo)、WebAuthn 认证和国际化(i18n)。前端静态文件嵌入二进制中,支持 Docker 部署。

思维导图

当前仓库信息不足,或结构不够稳定,暂时没有生成可靠的思维导图。

常见问题

New API 的主要功能是什么?

它是一个统一的 AI 模型网关,支持将多种 LLM 转换为 OpenAI、Claude 或 Gemini 兼容格式,提供模型聚合、分发、计费和多租户管理,简化 AI 服务集成。

如何部署 New API?

推荐使用 Docker Compose。步骤包括克隆仓库、配置 .env 文件(设置数据库、Redis 等环境变量)、运行 docker-compose up。详细命令参考 README 的 Quick Start 部分。

项目是否免费且稳定?

项目用于个人学习,开源免费,但作者声明无稳定性保证和技术支持。使用时需遵守 OpenAI 等服务条款及当地法律法规,不得用于非法用途。

支持哪些支付方式?

从依赖看,集成 Stripe 和 ePay 支付网关,具体配置需在 .env 文件中设置相关参数(如 Stripe 密钥、ePay 配置)。详细配置参考 .env.example 文件。

如何贡献代码或报告问题?

仓库未明确给出贡献指南,但可通过 GitHub 提交 issue 或 pull request。建议先查阅现有文档、代码规范及 LICENSE 条款,确保符合项目要求。