New API

在 AI 应用爆发式增长的今天，开发者往往面临一个棘手的难题：模型供应商众多，接口标准不一，密钥管理混乱，成本核算困难。

New API 是一款新一代的 AI 基座平台，旨在为您的 AI 应用提供统一的基础设施。它不仅是一个简单的代理网关，更是一个功能完备的AI 资产管理系统，能够承载所有 AI 应用，连接未来的统一接口平台。

🌐 核心能力：连接全球，统一入口

New API 无缝集成了全球主流 AI 服务提供商，涵盖 30+ 模型服务，包括但不限于：

• 文本对话：OpenAI (GPT-4/3.5), Anthropic (Claude 3), Google (Gemini), DeepSeek, Moonshot 等。
• 图像生成：Midjourney, Stable Diffusion, DALL-E 3 等。
• 音频创作：Suno, ElevenLabs 等。

通过 New API，您只需维护一个 API 端点，即可接入所有上述服务，且完全兼容 OpenAI 标准格式。这意味着您的现有代码无需大幅修改，即可轻松切换底层模型供应商。

🚀 六大核心特性

1. 统一接口，极简接入

• 标准化输出：将所有异构的模型接口统一转换为 OpenAI 兼容格式。
• 一次对接，无限扩展：应用层只需对接 New API，后端可随意增减或切换模型供应商，业务逻辑零感知。

2. 智能路由，高可用保障

• 负载均衡：支持多渠道分发，避免单点过载。
• 故障自动切换：当某条线路超时或报错时，系统自动切换至备用渠道，确保服务连续性。
• 策略灵活：支持加权随机、优先级排序等多种路由策略，优化响应速度与成功率。

3. 精细计费，成本可控

• 多维计费模式：支持按次数（Count）或按 Token 量（Amount）计费。
• 灵活充值体系：内置预付费充值功能，支持多倍率配置（如针对不同用户组设置不同的模型调用倍率）。
• 成本分析：清晰核算每个项目、每个用户的实际消耗，杜绝资源浪费。

4. 安全管控，权限分明

• 令牌管理：细粒度的 API Key 权限控制，可限制特定模型、特定额度或特定 IP。
• 访问审计：完整的 API 调用日志记录，支持追溯每一次请求的详情，满足企业合规需求。
• 模型隔离：可为不同租户分配不同的模型访问白名单。

5. 数据洞察，实时看板

• 可视化大屏：提供实时的数据看板，展示 QPS、Token 消耗、成功率等关键指标。
• 用量统计：多维度（时间、用户、模型）的用量统计报表，辅助运营决策。

6. 多租户架构，弹性扩展

• 完美适配：无论是个人开发者的单机部署，还是团队协作的多用户管理，亦或是企业级的大规模集群，New API 的多租户架构都能游刃有余地支撑。

📜 开源协议与许可

New API 采用 GNU AGPLv3 开源协议。

• 免费使用：只要您遵守开源协议（即如果您修改了代码并对外提供服务，需公开源代码），即可免费用于个人或商业项目。
• 社区驱动：依托开源社区的力量，持续迭代新功能，修复潜在漏洞。

🛠️ 快速开始：5 分钟私有化部署

New API 提供了极其便捷的 Docker 部署方案，支持 SQLite（轻量级）和 MySQL（生产级）两种数据库模式。

方式一：使用 Docker Compose（推荐）

这是最标准的部署方式，便于管理和维护。

# 1. 克隆项目代码
git clone https://github.com/QuantumNous/new-api.git  
cd new-api

# 2. 编辑配置文件（可根据需要修改端口、数据库密码等）
nano docker-compose.yml

# 3. 一键启动服务
docker-compose up -d

方式二：使用 Docker 命令直接运行

如果您希望更灵活地控制容器，可以使用以下命令。

方案 A：使用 SQLite（默认，适合个人或小团队）
无需额外配置数据库，数据自动保存在本地。

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

方案 B：使用 MySQL（适合生产环境）
需预先准备好 MySQL 实例，并替换 SQL_DSN 中的连接信息。

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

💡 小贴士：
-v ./data:/data 参数将容器内的数据目录映射到宿主机的 ./data 文件夹。建议将其修改为绝对路径（如 -v /opt/new-api/data:/data），以防误删。

🎉 立即体验

部署完成后，只需在浏览器访问 http://localhost:3000，即可进入 New API 的管理后台。

• 初始化管理员账号：首次访问需注册管理员账户。
• 添加渠道：在后台填入您的 OpenAI、Anthropic 等原始 API Key。
• 创建令牌：生成新的 API Key 供您的应用程序调用。