基于 new-api 二次开发的增强版 AI 中转系统
注释
本仓库为基于 的二次开发开源版本，保留上游项目标识、核心架构与主要文档结构
new-api适合作为二开功能整理、部署实践与后续持续迭代的公开代码仓库
如需查看原版能力、更新记录与完整官方文档，请优先参考上游 项目与文档
new-api
[!提示]
如果你准备直接部署此仓库，建议先阅读下方的快速开始与部署说明
如果你准备继续二次开发，建议定期与上游 保持对比，减少后续合并成本
new-api当前二开仓库地址：
https://github.com/xiaoer0215/Newapi-2.git下方保留的官方仓库、镜像与文档链接主要用于上游说明与兼容参考;如果你希望完全通过当前仓库分发，还需要同步维护你自己的Releases、镜像与文档页
重要
本项目仅供个人学习使用，不保证稳定性，且不提供任何技术支持
使用者必须在遵循 OpenAI 的 使用条款 以及法律法规的情况下使用，不得用于非法用途
根据 《生成式人工智能服务管理暂行办法》 的要求，请勿对中国地区公众提供一切未经备案的生成式人工智能服务
如果你想直接部署这个二级开发仓库，而不是从上游仓库开始，请使用：
git clone https://github.com/xiaoer0215/Newapi-2.gitcd Newapi-2注释：
官方仓库、映像和文档链接保存在下方，供上游参考和兼容性说明使用
如果你想通过这个分支完全分发，还应维护自己的发布、映像注册表、变更日志和文档主页
监控增强：增加了组监控和模型监控功能，提升了对状态、成功率和失败次数的可视化
用户和管理员界面调整：自定义登录/注册、模型市场、代币页面及相关交互
模型市场归因：模型市场页面由One-Hub模拟
用户端AI图像生成：包括由现场工作流程和平衡计费支持的基本AI图像生成条目
可自定义数据仪表盘：仪表盘模块可根据需要安排，并可额外为QQ组、支持联系人或类似用例设置两个二维码槽
个人速率限制：支持按分钟、小时和天数为每个用户设置请求限制
钱包和订阅管理：增加了可视化钱包折扣和奖金积分，以及按用户订阅详情管理订阅实例
兑换码与自动配送：兑换码可与关联用户一起搜索，自动配送支持商品列表以及卡片秘密导入和销售
日志和主页覆盖：支持请求日志、错误日志和使用/计费日志，修复自定义HTML主页覆盖无法完全覆盖导航栏和页脚的问题; 版权仍需保留
new-api账单查询改进：支持通过用户名或付款编号搜索支付记录，并取消了原始的订单编号显示逻辑
如果你希望直接使用当前二开仓库，而不是从上游仓库开始，请优先使用下面的仓库地址：
git clone https://github.com/xiaoer0215/Newapi-2.gitcd Newapi-2说明：
当前文档中保留的官方链接用于保留上游引用与能力说明
如果要做到“全部通过你自己的仓库部署”，还建议你补齐自己的二进制发布、Docker 镜像仓库、更新日志和文档首页
监控与展示增强：补充了分组监控与相关监控展示能力，支持不同时间窗口查看状态、失败次数、成功率等信息
数据看板定制：首页 / 数据看板支持按需要配置展示版块，并可额外放置最多两个联系二维码面板，可用于 QQ 群、客服微信等场景
前台与管理端 UI 调整：登录注册、模型广场、令牌管理、钱包管理等页面做了二开风格的界面与交互调整
用户端 AI 生图：新增独立 AI 生图入口，可按后台绘图分组自动识别模型，为用户自动创建生图专用令牌，并直接走站内余额结算
邀请奖励与审核风控：支持首次邀请奖励、首充达标奖励、后台人工审核、驳回理由、邀请余额发放，以及同 IP / 设备指纹 / 支付账户排查
签到与请求控制：在原有签到基础上增加 Turnstile、人机校验、同 IP 每日限制，以及 VPN / 代理 / 机房 / 住宅代理 IP 检测;同时支持用户个人限速，按分钟 / 小时 / 天设置请求上限
钱包、支付与账单：钱包管理界面支持折扣、赠送额度、到账额度等可视化展示，并支持钱包 / 订阅扣费偏好切换；充值账单侧支持按用户名或支付号检索记录
订阅与运营能力：补充订阅套餐、用户订阅实例管理、补时 / 赠送 / 作废等操作；兑换码支持后台搜索管理；自动发货支持商品上架、卡密导入与售卖
日志与首页覆盖能力：支持启用额度消费日志、请求错误日志等记录;首页与页脚支持 HTML / Markdown / iframe 方式自定义覆盖，适合完整替换首页展示，但仍需保留项目版权信息
排名不分先后
感谢 JetBrains 为本项目提供免费的开源开发许可证
# 克隆项目git clone https://github.com/QuantumNous/new-api.gitcd new-api# 编辑 docker-compose.yml 配置nano docker-compose.yml# 启动服务docker-compose up -d💡 提示： 会将数据保存在当前目录的 文件夹中，你也可以改为绝对路径如使用 Docker 命令
# 拉取最新镜像docker pull calciumion/new-api:latest# 使用 SQLite（默认）docker run --name new-api -d --restart always \
-p 3000:3000 \
-e TZ=Asia/Shanghai \
-v ./data:/data \
calciumion/new-api:latest# 使用 MySQLdocker 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:/datadata-v /your/custom/path:/data
🎉 部署完成后，访问 即可使用！http://localhost:3000
📖 更多部署方式请参考 部署指南
📖 官方文档 |
快速导航：
分类 链接 🚀 部署指南 安装文档 ⚙️ 环境配置 环境变量 📡 接口文档 API 文档 ❓ 常见问题 常见问题 💬 社区交流 交流渠道
详细特性请参考 特性说明
特性 说明 🎨 全新用户界面 现代化的用户界面设计 🌍 多语言 支持中文、英文、法语、日语 🔄 数据兼容 完全兼容原版 One API 数据库 📈 数据看板 可视化控制台与统计分析 🔒 权限管理 令牌分组、模型限制、用户管理
✅ 在线充值（易支付、Stripe）
✅ 模型按次数收费
✅ 缓存计费支持（OpenAI、Azure、DeepSeek、Claude、Qwen等所有支持的模型）
✅ 灵活的计费策略配置
😈 Discord 授权登录
🤖 LinuxDO 授权登录
📱 Telegram 授权登录
🔑 OIDC 统一认证
🔍 Key 查询使用额度（配合 neko-api-key-tool）
API 格式支持：
⚡ OpenAI Realtime API（含 Azure）
⚡ 克劳德·梅斯
⚡ 谷歌Gemini
🔄 Rerank 模型（Cohere、Jina）
智能路由：
⚖️ 渠道加权随机
🔄 失败自动重试
🚦 用户级别模型限流
格式转换：
🔄 OpenAI 兼容 ⇄ Claude 消息
🔄 OpenAI 兼容 → Google Gemini
🔄 Google Gemini → OpenAI 兼容 - 仅支持文本，暂不支持函数调用
🚧 OpenAI 兼容 ⇄ OpenAI Responses - 开发中
🔄 思考转内容功能
推理努力 支持：
OpenAI 系列模型： Claude 思考模型： 谷歌 Gemini 系列模型： 也可以直接在 Gemini 模型名称后追加 / / 来控制思考力度（无需再设置思考预算后缀）查看详细配置
o3-mini-high- 高推理努力o3-mini-medium- 中等推理努力o3-mini-low- 推理努力低gpt-5-high- 高推理努力gpt-5-medium- 中等推理努力gpt-5-low- 推理努力低claude-3-7-sonnet-20250219-thinking- 启用思考模式gemini-2.5-flash-thinking- 启用思考模式gemini-2.5-flash-nothinking- 禁用思考模式gemini-2.5-pro-thinking- 启用思考模式gemini-2.5-pro-thinking-128- 启用思考模式，并设置思考预算为128tokens-low-medium-high
详情请参考 接口文档 - 中继接口
模型类型 说明 文档 🤖 OpenAI 兼容 OpenAI 兼容模型 文档 🤖 OpenAI的回应 OpenAI Responses 格式 文档 🎨 中途-代理 Midjourney-Proxy（Plus） 文档 🎵 Suno-API Suno API 文档 🔄 晋升 Cohere、Jina 文档 💬 克洛德 消息格式 文档 🌐 双子座 Google Gemini 格式 文档 🔧 Dify ChatFlow 模式 - 🎯 自定义 支持完整调用地址 -
提示
最新版 Docker 镜像： calciumion/new-api:latest
组件 要求 本地数据库 SQLite（Docker 需挂载 目录） /data远程数据库 MySQL ≥ 5.7.8 或 PostgreSQL ≥ 9.6 容器引擎 Docker / Docker 组合
📖 完整配置： 环境变量文档常用环境变量配置
变量名 说明 默认值 SESSION_SECRET会话密钥（多机部署必须） - CRYPTO_SECRET加密密钥（Redis 必须） - SQL_DSN数据库连接字符串 - REDIS_CONN_STRINGRedis 连接字符串 - STREAMING_TIMEOUT流式超时时间（秒） 300STREAM_SCANNER_MAX_BUFFER_MB流式扫描器单行最大缓冲（MB），图像生成等超大 片段（如 4K 图片 base64）需适当调大 data:64MAX_REQUEST_BODY_MB请求体最大大小（MB，解压后计;防止超大请求/zip bomb 导致内存暴涨），超过将返回 41332AZURE_DEFAULT_API_VERSIONAzure API 版本 2025-04-01-previewERROR_LOG_ENABLED错误日志开关 falsePYROSCOPE_URLPyroscope 服务地址 - PYROSCOPE_APP_NAMEPyroscope 应用名 new-apiPYROSCOPE_BASIC_AUTH_USERPyroscope Basic Auth 用户名 - PYROSCOPE_BASIC_AUTH_PASSWORDPyroscope Basic Auth 密码 - PYROSCOPE_MUTEX_RATEPyroscope mutex 采样率 5PYROSCOPE_BLOCK_RATEPyroscope 块采样率 5HOSTNAMEPyroscope 标签里的主机名 new-api
使用 SQLite： 使用 MySQL： 💡 路径说明： 也可使用绝对路径，如：方式 1：Docker Compose（推荐）
# 克隆项目git clone https://github.com/QuantumNous/new-api.gitcd new-api# 编辑配置nano docker-compose.yml# 启动服务docker-compose up -d
方式 2：Docker 命令
docker run --name new-api -d --restart always \
-p 3000:3000 \
-e TZ=Asia/Shanghai \
-v ./data:/data \
calciumion/new-api:latest
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
./data:/data- 相对路径，数据保存在当前目录的 data 文件夹/your/custom/path:/data
警告
必须设置 - 否则登录状态不一致
SESSION_SECRET公用 Redis 必须设置 - 否则数据无法解密
CRYPTO_SECRET
重试配置： 设置 → 运营设置 → 通用设置 → 失败重试次数
缓存配置：
REDIS_CONN_STRING：Redis 缓存（推荐）MEMORY_CACHE_ENABLED：内存缓存
项目 说明 一个API 原版项目基础 中途-代理 Midjourney 接口支持
项目 说明 neko-api-key-tool Key 额度查询工具 新API-地平线 新API 高性能优化版
资源 链接 📘 常见问题 常见问题 💬 社区交流 交流渠道 🐛 反馈问题 问题反馈 📚 完整文档 官方文档
欢迎各种形式的贡献！
🐛 报告 Bug
💡 提出新功能
📝 改进文档
🔧 提交代码
本项目采用 GNU Affero 通用公共许可证 v3.0 （AGPLv3） 授权。
本项目为开源项目，在 One API（MIT 许可证）的基础上进行二次开发。
如果您所在的组织政策不允许使用 AGPLv3 许可的软件，或您希望规避 AGPLv3 的开源义务，请发送邮件至：support@quantumnous.com
