Files

FNS Service 682e3e52df Update from Sync Service

2026-06-22 11:30:51 +08:00

7.6 KiB

Executable File

Raw Permalink Blame History

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 对接百炼步骤

部署 New API

docker run -d --name new-api -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

添加阿里云渠道
- 进入管理后台 → 渠道管理 → 添加渠道
- 选择 阿里云 (Ali) 类型 (Channel Type: 17)
- 填写 百炼 API Key
- BASE_URL 默认已填: https://dashscope.aliyuncs.com
- 选择要启用的模型
创建 Token
- 令牌管理 → 创建令牌
- 生成 API Key 供下游应用使用

下游应用调用

from openai import OpenAI

client = OpenAI(
    api_key=***  # New API 生成的 Token
    base_url="http://localhost:3000/v1",  # New API 地址
)

渠道额外设置

{
    "force_format": true,        // 强制格式化为 OpenAI 格式
    "thinking_to_content": true, // 将思考内容转为 <think> 标签
    "proxy": "socks5://xxx"      // 网络代理
}

🐳 部署方式

Docker Compose（推荐）

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）

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 网关，适合：

个人开发者: 统一管理多个 AI 提供商的 API Key
企业用户: 组织级鉴权、成本核算、用量统计
API 转售: 支持多租户、配额管理、计费系统

百炼对接优势:

原生支持阿里云渠道 (Channel Type 17)
百炼提供 OpenAI 兼容接口，迁移成本低
千问模型性价比高，适合各种场景
支持缓存统计，可降低成本

推荐部署方式: Docker Compose，包含 PostgreSQL + Redis，适合生产环境。

7.6 KiB Executable File Raw Permalink Blame History Unescape Escape