New API：OpenAI 接口中转与管理系统

为什么需要 New API？

随着 OpenAI 等 AI 服务的普及，许多开发者和企业在实际项目中面临多重挑战：官方接口访问不稳定、多项目密钥管理混乱、费用控制困难、以及不同模型之间的切换繁琐。New API 正是为了解决这些痛点而诞生的开源项目。它就像一个智能的 API 路由器，将你所有的 AI 接口请求集中转发，同时提供完善的鉴权、限流和日志功能，让你不再为接口的稳定性与安全性操心。

New API 的核心功能

多渠道接入与智能路由

New API 支持接入多种上游渠道，包括 OpenAI 官方接口、Azure OpenAI、以及各种第三方代理。你可以为每个渠道设置权重，系统会根据权重自动分配请求，实现负载均衡。当某个渠道不可用时，它会自动切换至其他可用渠道，极大提升了服务的可用性。

灵活的令牌管理与配额控制

项目内置了令牌（Token）管理系统，你可以为不同的团队或项目创建独立的 API 密钥，并设置额度、过期时间和速率限制。每个密钥的调用次数和消耗 tokens 都会被记录，方便进行成本核算和审计。

可视化的监控与日志

New API 提供了简洁的 Web 管理面板，可以实时查看所有请求的日志，包括响应时间、状态码、消耗 tokens 等。这些数据以图表形式呈现，帮助开发者快速定位异常请求，优化资源分配。

安装与使用步骤

New API 的部署非常简便，支持 Docker 和源码两种方式。以下以 Docker 为例：

• 环境准备：安装 Docker 和 Docker Compose（版本不低于 3.8）。
• 获取项目：在服务器上执行 git clone https://github.com/Calcium-Ion/new-api.git 并进入目录。
• 修改配置：编辑 docker-compose.yml，根据注释设置数据库密码、端口等参数。
• 启动服务：运行 docker-compose up -d，等待镜像拉取和容器启动。
• 初始化：访问 http://<你的IP>:3000，使用默认管理员账号 root 和密码 123456 登录，然后立即修改密码。

在管理面板中，你需要先添加渠道（如 OpenAI），再创建令牌。调用时，将 New API 的地址作为 base_url，并用生成的令牌作为 API key，即可无缝替换原本直连官方接口的代码。

注意事项

• 许可证：New API 使用 MIT 许可证，允许商业使用和二次开发，但需保留原作者的版权声明。
• 安全加固：生产环境请务必启用 HTTPS，并限制管理面板的访问 IP，避免暴露在公网。
• 数据备份：定期备份数据库，尤其是 tokens 和日志数据，防止意外丢失。
• 上游稳定性：即便有自动切换，也建议搭配健康检查工具，确保上游渠道的可用性。