Update from Sync Service

2026-06-22 11:30:51 +08:00
parent eb80b7a8c1
commit 682e3e52df
52 changed files with 10099 additions and 191 deletions
--- a/AI工程/New_API_研究报告.md
+++ b/AI工程/New_API_研究报告.md
@@ -0,0 +1,311 @@
+# 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，适合生产环境。