New API

🍥 新一代大模型網關與AI資產管理系統

📝 項目說明

[!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}