New API

🍥 新一代大模型网关与AI资产管理系统

</a><!-- --><a href="https://github.com/Calcium-Ion/new-api/releases/latest">

</a><!-- --><a href="https://hub.docker.com/r/CalciumIon/new-api">

</a><!-- --><a href="https://goreportcard.com/report/github.com/Calcium-Ion/new-api">

</a><!-- --><a href="https://www.producthunt.com/products/new-api/launches/new-api?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-new-api" target="_blank" rel="noopener noreferrer">

📝 项目说明

[!IMPORTANT]

• 本项目仅供个人学习使用，不保证稳定性，且不提供任何技术支持
• 使用者必须在遵循 OpenAI 的 使用条款 以及法律法规的情况下使用，不得用于非法用途
• 根据 《生成式人工智能服务管理暂行办法》 的要求，请勿对中国地区公众提供一切未经备案的生成式人工智能服务

🤝 我们信任的合作伙伴

</a><!-- --><a href="https://github.com/iOfficeAI/AionUi/" target="_blank">

</a><!-- --><a href="https://bda.pku.edu.cn/" target="_blank">

</a><!-- --><a href="https://www.compshare.cn/?ytag=GPU_yy_gh_newapi" target="_blank">

</a><!-- --><a href="https://www.aliyun.com/" target="_blank">

</a><!-- --><a href="https://io.net/" target="_blank">

🙏 特别鸣谢

🚀 快速开始

使用 Docker Compose（推荐）

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

# 编辑 docker-compose.yml 配置
nano docker-compose.yml

# 启动服务
docker-compose up -d

# 拉取最新镜像
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

# 使用 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 ./data:/data \
  calciumion/new-api:latest

💡 提示： -v ./data:/data 会将数据保存在当前目录的 data 文件夹中，你也可以改为绝对路径如 -v /your/custom/path:/data

🎉 部署完成后，访问 http://localhost:3000 即可使用！

📖 更多部署方式请参考 部署指南

📚 文档

📖 官方文档 |

快速导航：

✨ 主要特性

详细特性请参考 特性说明

🎨 核心功能

💰 支付与计费

• ✅ 在线充值（易支付、Stripe）
• ✅ 模型按次数收费
• ✅ 缓存计费支持（OpenAI、Azure、DeepSeek、Claude、Qwen等所有支持的模型）
• ✅ 灵活的计费策略配置

🔐 授权与安全

• 😈 Discord 授权登录
• 🤖 LinuxDO 授权登录
• 📱 Telegram 授权登录
• 🔑 OIDC 统一认证
• 🔍 Key 查询使用额度（配合 neko-api-key-tool）

🚀 高级功能

API 格式支持：

• ⚡ OpenAI Responses
• ⚡ OpenAI Realtime API（含 Azure）
• ⚡ Claude Messages
• ⚡ Google Gemini
• 🔄 Rerank 模型（Cohere、Jina）

智能路由：

• ⚖️ 渠道加权随机
• 🔄 失败自动重试
• 🚦 用户级别模型限流

格式转换：

• 🔄 OpenAI Compatible ⇄ Claude Messages
• 🔄 OpenAI Compatible → Google Gemini
• 🔄 Google Gemini → OpenAI Compatible - 仅支持文本，暂不支持函数调用
• 🚧 OpenAI Compatible ⇄ OpenAI Responses - 开发中
• 🔄 思考转内容功能

Reasoning Effort 支持：

OpenAI 系列模型：

• o3-mini-high - High reasoning effort
• o3-mini-medium - Medium reasoning effort
• o3-mini-low - Low reasoning effort
• gpt-5-high - High reasoning effort
• gpt-5-medium - Medium reasoning effort
• gpt-5-low - Low reasoning effort

Claude 思考模型：

• claude-3-7-sonnet-20250219-thinking - 启用思考模式

Google Gemini 系列模型：

• gemini-2.5-flash-thinking - 启用思考模式
• gemini-2.5-flash-nothinking - 禁用思考模式
• gemini-2.5-pro-thinking - 启用思考模式
• gemini-2.5-pro-thinking-128 - 启用思考模式，并设置思考预算为128tokens
• 也可以直接在 Gemini 模型名称后追加 -low / -medium / -high 来控制思考力度（无需再设置思考预算后缀）

🤖 模型支持

详情请参考 接口文档 - 中继接口

📡 支持的接口

• 聊天接口 (Chat Completions)
• 响应接口 (Responses)
• 图像接口 (Image)
• 音频接口 (Audio)
• 视频接口 (Video)
• 嵌入接口 (Embeddings)
• 重排序接口 (Rerank)
• 实时对话 (Realtime)
• Claude 聊天
• Google Gemini 聊天

🚢 部署

[!TIP] 最新版 Docker 镜像： calciumion/new-api:latest

📋 部署要求

⚙️ 环境变量配置

📖 完整配置： 环境变量文档

🔧 部署方式

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

# 编辑配置
nano docker-compose.yml

# 启动服务
docker-compose up -d

使用 SQLite：

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/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 ./data:/data \
  calciumion/new-api:latest

💡 路径说明：

• ./data:/data - 相对路径，数据保存在当前目录的 data 文件夹
• 也可使用绝对路径，如：/your/custom/path:/data

1. 安装宝塔面板（≥ 9.2.0 版本）
2. 在应用商店搜索 New-API
3. 一键安装

📖 图文教程

⚠️ 多机部署注意事项

[!WARNING]

• 必须设置 SESSION_SECRET - 否则登录状态不一致
• 公用 Redis 必须设置 CRYPTO_SECRET - 否则数据无法解密

🔄 渠道重试与缓存

重试配置： 设置 → 运营设置 → 通用设置 → 失败重试次数

缓存配置：

• REDIS_CONN_STRING：Redis 缓存（推荐）
• MEMORY_CACHE_ENABLED：内存缓存

🔗 相关项目

上游项目

配套工具

💬 帮助支持

📖 文档资源

🤝 贡献指南

欢迎各种形式的贡献！

• 🐛 报告 Bug
• 💡 提出新功能
• 📝 改进文档
• 🔧 提交代码

📜 许可证

本项目采用 GNU Affero 通用公共许可证 v3.0 (AGPLv3) 授权。

本项目为开源项目，在 One API（MIT 许可证）的基础上进行二次开发。

如果您所在的组织政策不允许使用 AGPLv3 许可的软件，或您希望规避 AGPLv3 的开源义务，请发送邮件至：[email protected]

🌟 Star History

💖 感谢使用 New API

如果这个项目对你有帮助，欢迎给我们一个 ⭐️ Star！

官方文档 • 问题反馈 • 最新发布

_{Built with ❤️ by QuantumNous}