New API：开源大模型网关与 AI 资产管理系统，30+ 服务商支持！

New API 是基于 One API 深度二次开发的新一代大模型网关与 AI 资产管理系统，提供统一的接口管理与分发能力，让个人和企业能够便捷地接入并管理多种主流大模型服务，支持 OpenAI、Anthropic、Midjourney 等格式，覆盖 30+ AI 服务商，保证 99.9% 服务可用性并兼容多语言环境。该系统具备一键部署、灵活计费、安全稳定等亮点，可满足各类 AI 应用场景需求。

New API主要特性：

🎨 全新的UI界面
🌍 多语言支持
💰 支持在线充值功能（易支付）
🔍 支持用key查询使用额度（配合neko-api-key-tool）
🔄 兼容原版One API的数据库
💵 支持模型按次数收费
⚖️ 支持渠道加权随机
📈 数据看板（控制台）
🔒 令牌分组、模型限制
🤖 支持更多授权登陆方式（LinuxDO,Telegram、OIDC）
🔄 支持Rerank模型（Cohere和Jina），接口文档
⚡ 支持OpenAI Realtime API（包括Azure渠道），接口文档
⚡ 支持Claude Messages 格式，接口文档
支持使用路由/chat2link进入聊天界面
🧠 支持通过模型名称后缀设置 reasoning effort：
1. OpenAI o系列模型
  - 添加后缀 -high 设置为 high reasoning effort (例如: o3-mini-high)
  - 添加后缀 -medium 设置为 medium reasoning effort (例如: o3-mini-medium)
  - 添加后缀 -low 设置为 low reasoning effort (例如: o3-mini-low)
2. Claude 思考模型
  - 添加后缀 -thinking 启用思考模式 (例如: claude-3-7-sonnet-20250219-thinking)
🔄 思考转内容功能
🔄 针对用户的模型限流功能
💰 缓存计费支持，开启后可以在缓存命中时按照设定的比例计费：
1. 在 系统设置-运营设置 中设置 提示缓存倍率 选项
2. 在渠道中设置 提示缓存倍率，范围 0-1，例如设置为 0.5 表示缓存命中时按照 50% 计费
3. 支持的渠道：
  - OpenAI
  - Azure
  - DeepSeek
  - Claude

New API环境变量

GENERATE_DEFAULT_TOKEN：是否为新注册用户生成初始令牌，默认为 false
STREAMING_TIMEOUT：流式回复超时时间，默认120秒
DIFY_DEBUG：Dify渠道是否输出工作流和节点信息，默认 true
FORCE_STREAM_OPTION：是否覆盖客户端stream_options参数，默认 true
GET_MEDIA_TOKEN：是否统计图片token，默认 true
GET_MEDIA_TOKEN_NOT_STREAM：非流情况下是否统计图片token，默认 true
UPDATE_TASK：是否更新异步任务（Midjourney、Suno），默认 true
COHERE_SAFETY_SETTING：Cohere模型安全设置，可选值为 NONE, CONTEXTUAL, STRICT，默认 NONE
GEMINI_VISION_MAX_IMAGE_NUM：Gemini模型最大图片数量，默认 16
MAX_FILE_DOWNLOAD_MB: 最大文件下载大小，单位MB，默认 20
CRYPTO_SECRET：加密密钥，用于加密数据库内容
AZURE_DEFAULT_API_VERSION：Azure渠道默认API版本，默认 2025-04-01-preview
NOTIFICATION_LIMIT_DURATION_MINUTE：通知限制持续时间，默认 10分钟
NOTIFY_LIMIT_COUNT：用户通知在指定持续时间内的最大数量，默认 2
ERROR_LOG_ENABLED=true: 是否记录并显示错误日志，默认false

New API核心优势

统一调用：支持 OpenAI、Claude、Midjourney 等多种模型格式，可按需切换渠道
全新 UI 与多语言：界面重新设计，内置中英等多语言，提升全球团队协作效率
一键部署：Docker 与常规环境均提供开箱即用脚本，最快数分钟上线
灵活计费：按调用次数计费，并可通过易支付在线充值，成本透明可控
安全与稳定：多级令牌、模型限制与渠道加权随机算法，确保高并发场景下的稳定性

New API关键功能

统一模型网关

通过自研路由层，New API 将各家模型封装为 OpenAI 兼容协议，开发者仅需更新 API Base 即可完成迁移。

灵活计费与充值

平台内置按次计费逻辑，可为不同模型设定单价；接入易支付后，用户可自助充值并实时查看余额。

Realtime API 支持

New API 原生接入 OpenAI Realtime API 及 Azure 通道，让语音-语音或多模态实时交互更低延迟。

Rerank 模型扩展

平台已适配 Cohere Rerank 与 Jina Reranker，可在搜索或 RAG 场景中对结果进行语义重排，提高相关性。

多样化登录与限流

支持 LinuxDO、Telegram、OIDC 等第三方登录方式，并可针对单一用户或令牌设置 QPS 与模型白名单，避免滥用。

New API使用场景

场景	价值
企业内部 AI 中台	用统一接口管理多云与本地模型，避免供应商锁定
SaaS 创业团队	通过按次计费将模型成本直接转嫁到终端用户
AI 应用开发者	借助 Realtime API 构建语音助手或流式翻译
搜索 / RAG 系统	利用 Rerank 模型提升检索结果质量

New API快速上手

克隆或下载项目源码并执行一键部署脚本
登录控制台，添加模型渠道和密钥
在「令牌」页面创建访问令牌
将应用中的 OPENAI_API_BASE 指向新网关地址，键值为刚生成的令牌即可调用

New API部署指南

最新版Docker镜像：calciumion/new-api:latest

多机部署注意事项

必须设置环境变量 SESSION_SECRET，否则会导致多机部署时登录状态不一致
如果公用Redis，必须设置 CRYPTO_SECRET，否则会导致多机部署时Redis内容无法获取

部署要求

本地数据库（默认）：SQLite（Docker部署必须挂载/data目录）
远程数据库：MySQL版本 >= 5.7.8，PgSQL版本 >= 9.6

部署方式

使用宝塔面板Docker功能部署

安装宝塔面板（9.2.0版本及以上），在应用商店中找到New-API安装即可。

使用Docker Compose部署（推荐）

借助 New API，团队能够以最小成本整合并管理前沿大模型，快速落地多语言智能应用，同时保持计费透明与系统高可用。

# 下载项目
git clone https://github.com/Calcium-Ion/new-api.git
cd new-api
# 按需编辑docker-compose.yml
# 启动
docker-compose up -d

直接使用Docker镜像

# 使用SQLite
docker run --name new-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -v /home/ubuntu/data/new-api:/data calciumion/new-api:latest

# 使用MySQL
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 /home/ubuntu/data/new-api:/data calciumion/new-api:latest