312 lines
7.6 KiB
Markdown
Executable File
312 lines
7.6 KiB
Markdown
Executable File
# New API 研究报告
|
||
|
||
**研究日期**: 2026-06-09
|
||
**项目**: QuantumNous/new-api
|
||
**Stars**: 37,729 ⭐
|
||
**语言**: Go
|
||
**最新版本**: v1.0.0-rc.10 (2026-05-26)
|
||
**官网**: https://www.newapi.ai
|
||
**文档**: https://docs.newapi.pro
|
||
|
||
---
|
||
|
||
## 📋 项目概述
|
||
|
||
**New API** 是下一代 LLM 网关和 AI 资产管理系统，是 One API 的增强版本。它将多个 AI 模型提供商统一转换为 OpenAI/Claude/Gemini 兼容格式，提供集中化的模型管理平台。
|
||
|
||
### 核心定位
|
||
- **AI API 网关**: 聚合多个 AI 提供商，统一接口
|
||
- **企业级管理**: 组织级鉴权、用量统计、成本核算
|
||
- **私有化部署**: 支持 Docker 一键部署
|
||
- **格式转换**: OpenAI ⇄ Claude ⇄ Gemini 互相转换
|
||
|
||
---
|
||
|
||
## 🚀 核心功能
|
||
|
||
### 1. 多协议支持
|
||
- ⚡ **OpenAI Responses API** (最新格式)
|
||
- ⚡ **OpenAI Realtime API** (包括 Azure)
|
||
- ⚡ **Claude Messages API**
|
||
- ⚡ **Google Gemini API**
|
||
- 🔄 **Rerank Models** (Cohere, Jina)
|
||
|
||
### 2. 智能路由
|
||
- ⚖️ 渠道加权随机
|
||
- 🔄 失败自动重试
|
||
- 🚦 用户级模型限流
|
||
- 💾 缓存命中统计 (OpenAI/Azure/DeepSeek/Claude/Qwen)
|
||
|
||
### 3. 格式转换
|
||
- OpenAI Compatible ⇄ Claude Messages
|
||
- OpenAI Compatible → Google Gemini
|
||
- Google Gemini → OpenAI Compatible (仅文本)
|
||
- 🔄 思考内容转换 (thinking-to-content)
|
||
|
||
### 4. 推理努力控制
|
||
**OpenAI 系列**:
|
||
- o3-mini-high/medium/low
|
||
- gpt-5-high/medium/low
|
||
|
||
**Claude 系列**:
|
||
- claude-3-7-sonnet-thinking
|
||
|
||
**Gemini 系列**:
|
||
- gemini-2.5-flash-thinking/nothinking
|
||
- gemini-2.5-pro-thinking
|
||
- 支持 -low/-medium/-high 后缀
|
||
|
||
### 5. 计费与配额
|
||
- ✅ 内部充值和配额分配 (EPay, Stripe)
|
||
- ✅ 按请求/用量/缓存命中率成本核算
|
||
- ✅ 灵活计费策略
|
||
- ✅ 企业客户管理
|
||
|
||
### 6. 权限管理
|
||
- 🔑 Token 分组
|
||
- 🔒 模型限制
|
||
- 👥 用户管理
|
||
- 🔐 多种登录方式 (Discord/LinuxDO/Telegram/OIDC)
|
||
|
||
---
|
||
|
||
## 📡 支持的渠道类型 (50+)
|
||
|
||
| 渠道类型 | 编号 | 默认 BASE_URL |
|
||
|---------|------|---------------|
|
||
| OpenAI | 1 | https://api.openai.com |
|
||
| Azure | 3 | - |
|
||
| Anthropic | 14 | https://api.anthropic.com |
|
||
| **阿里云 (Ali)** | **17** | **https://dashscope.aliyuncs.com** |
|
||
| 百度文心 | 15/46 | https://aip.baidubce.com |
|
||
| 智谱 | 16/26 | https://open.bigmodel.cn |
|
||
| Gemini | 24 | https://generativelanguage.googleapis.com |
|
||
| Moonshot | 25 | https://api.moonshot.cn |
|
||
| DeepSeek | 43 | - |
|
||
| 火山引擎 | 45 | - |
|
||
| OpenRouter | 20 | https://openrouter.ai/api |
|
||
| Cohere | 34 | https://api.cohere.ai |
|
||
| MiniMax | 35 | https://api.minimax.chat |
|
||
| Mistral | 42 | - |
|
||
| xAI | 48 | - |
|
||
| 更多... | - | - |
|
||
|
||
---
|
||
|
||
## 🔗 阿里云百炼对接
|
||
|
||
### 百炼 OpenAI 兼容接口
|
||
|
||
阿里云百炼的千问模型支持 OpenAI 兼容接口，只需调整 API Key、BASE_URL 和模型名称。
|
||
|
||
### 配置信息
|
||
|
||
**BASE_URL (SDK)**:
|
||
- 北京: `https://dashscope.aliyuncs.com/compatible-mode/v1`
|
||
- 弗吉尼亚: `https://dashscope-us.aliyuncs.com/compatible-mode/v1`
|
||
- 新加坡: `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
|
||
|
||
**HTTP Endpoint**:
|
||
- 北京: `POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions`
|
||
|
||
### 支持的千问模型
|
||
|
||
**商业版**:
|
||
- **千问 Max**: qwen3.7-max, qwen3-max, qwen-max
|
||
- **千问 Plus**: qwen3.6-plus, qwen3.5-plus, qwen-plus
|
||
- **千问 Flash**: qwen3.6-flash, qwen3.5-flash, qwen-flash
|
||
- **千问 Coder**: qwen3-coder-plus, qwen3-coder-flash
|
||
- **QwQ**: qwq-plus
|
||
|
||
**开源版**:
|
||
- qwen3.6-35b-a3b, qwen3.5-397b-a17b, qwen3.5-122b-a10b
|
||
- qwen3-235b-a22b, qwen3-32b, qwen3-30b-a3b, qwen3-14b, qwen3-8b
|
||
|
||
### New API 对接百炼步骤
|
||
|
||
1. **部署 New API**
|
||
```bash
|
||
docker run -d --name new-api -p 3000:3000 \
|
||
-e TZ=Asia/Shanghai \
|
||
-v ./data:/data \
|
||
calciumion/new-api:latest
|
||
```
|
||
|
||
2. **添加阿里云渠道**
|
||
- 进入管理后台 → 渠道管理 → 添加渠道
|
||
- 选择 **阿里云 (Ali)** 类型 (Channel Type: 17)
|
||
- 填写 **百炼 API Key**
|
||
- BASE_URL 默认已填: `https://dashscope.aliyuncs.com`
|
||
- 选择要启用的模型
|
||
|
||
3. **创建 Token**
|
||
- 令牌管理 → 创建令牌
|
||
- 生成 API Key 供下游应用使用
|
||
|
||
4. **下游应用调用**
|
||
```python
|
||
from openai import OpenAI
|
||
|
||
client = OpenAI(
|
||
api_key=*** # New API 生成的 Token
|
||
base_url="http://localhost:3000/v1", # New API 地址
|
||
)
|
||
```
|
||
|
||
### 渠道额外设置
|
||
```json
|
||
{
|
||
"force_format": true, // 强制格式化为 OpenAI 格式
|
||
"thinking_to_content": true, // 将思考内容转为 <think> 标签
|
||
"proxy": "socks5://xxx" // 网络代理
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🐳 部署方式
|
||
|
||
### Docker Compose（推荐）
|
||
|
||
```yaml
|
||
version: '3.4'
|
||
services:
|
||
new-api:
|
||
image: calciumion/new-api:latest
|
||
container_name: new-api
|
||
restart: always
|
||
ports:
|
||
- "3000:3000"
|
||
volumes:
|
||
- ./data:/data
|
||
- ./logs:/app/logs
|
||
environment:
|
||
- SQL_DSN=postgresql://root:123456@postgres:5432/new-api
|
||
- REDIS_CONN_STRING=redis://:123456@redis:6379
|
||
- TZ=Asia/Shanghai
|
||
depends_on:
|
||
- redis
|
||
- postgres
|
||
|
||
redis:
|
||
image: redis:latest
|
||
restart: always
|
||
command: ["redis-server", "--requirepass", "123456"]
|
||
|
||
postgres:
|
||
image: postgres:15
|
||
restart: always
|
||
environment:
|
||
POSTGRES_USER: root
|
||
POSTGRES_PASSWORD: 123456
|
||
POSTGRES_DB: new-api
|
||
volumes:
|
||
- pg_data:/var/lib/postgresql/data
|
||
```
|
||
|
||
### Docker 单容器（SQLite）
|
||
|
||
```bash
|
||
docker run --name new-api -d --restart always \
|
||
-p 3000:3000 \
|
||
-e TZ=Asia/Shanghai \
|
||
-v ./data:/data \
|
||
calciumion/new-api:latest
|
||
```
|
||
|
||
部署后访问: `http://localhost:3000`
|
||
|
||
---
|
||
|
||
## 📊 支持的接口
|
||
|
||
- Chat Interface (Chat Completions)
|
||
- Response Interface (Responses)
|
||
- Image Interface (Image)
|
||
- Audio Interface (Audio)
|
||
- Video Interface (Video)
|
||
- Embedding Interface (Embeddings)
|
||
- Rerank Interface (Rerank)
|
||
- Realtime Conversation (Realtime)
|
||
- Claude Chat
|
||
- Google Gemini Chat
|
||
|
||
---
|
||
|
||
## 🌍 多语言支持
|
||
|
||
- 简体中文
|
||
- 繁体中文
|
||
- English
|
||
- Français
|
||
- 日本語
|
||
|
||
---
|
||
|
||
## 🎨 UI 特性
|
||
|
||
- 现代化界面设计
|
||
- 数据看板（可视化控制台和统计分析）
|
||
- 主题定制（支持 Anthropic/Simple Large 预设）
|
||
- 响应式设计（移动端友好）
|
||
- 暗色模式
|
||
|
||
---
|
||
|
||
## 🔐 认证方式
|
||
|
||
- Discord 授权登录
|
||
- LinuxDO 授权登录
|
||
- Telegram 授权登录
|
||
- OIDC 统一认证
|
||
|
||
---
|
||
|
||
## 💡 使用场景
|
||
|
||
### 个人开发者
|
||
- 统一管理多个 AI 提供商的 API Key
|
||
- 跨平台模型切换
|
||
- 用量追踪
|
||
|
||
### 企业用户
|
||
- 组织级鉴权和权限管理
|
||
- 成本核算和计费系统
|
||
- 多租户管理
|
||
- 用量统计和分析
|
||
|
||
### API 转售
|
||
- 支持多租户
|
||
- 配额管理
|
||
- 计费系统 (EPay, Stripe)
|
||
- 缓存优化降低成本
|
||
|
||
---
|
||
|
||
## 🔗 相关资源
|
||
|
||
- **官方文档**: https://docs.newapi.pro
|
||
- **GitHub**: https://github.com/QuantumNous/new-api
|
||
- **Docker Hub**: https://hub.docker.com/r/calciumion/new-api
|
||
- **One API (原版)**: https://github.com/songquanpeng/one-api
|
||
- **百炼文档**: https://help.aliyun.com/zh/model-studio/
|
||
- **Key 工具**: https://github.com/Calcium-Ion/new-api-key-tool
|
||
|
||
---
|
||
|
||
## 📝 总结
|
||
|
||
**New API** 是一个功能强大的 AI API 网关，适合：
|
||
|
||
1. **个人开发者**: 统一管理多个 AI 提供商的 API Key
|
||
2. **企业用户**: 组织级鉴权、成本核算、用量统计
|
||
3. **API 转售**: 支持多租户、配额管理、计费系统
|
||
|
||
**百炼对接优势**:
|
||
- 原生支持阿里云渠道 (Channel Type 17)
|
||
- 百炼提供 OpenAI 兼容接口，迁移成本低
|
||
- 千问模型性价比高，适合各种场景
|
||
- 支持缓存统计，可降低成本
|
||
|
||
**推荐部署方式**: Docker Compose，包含 PostgreSQL + Redis，适合生产环境。
|