convez.ai
PluginIntegração & APIsAvançado
vam12375

Shushu API - Gateway e Plataforma de Gerenciamento de IA

vam12375/shushu-api

Gateway AI com agregação multi-modelo, faturamento e dashboard gerencial

Ver no GitHub
BomPluginScore · de 0 a 100

Gateway AI unificado que agrega 40+ fornecedores de modelos (OpenAI, Claude, Gemini, etc.) em uma interface compatível com OpenAI. Fornece gerenciamento de faturamento, limite de taxa, logging e painel operacional para organizações que precisam controlar múltiplas contas de API de IA em escala.

Instalação

$npx convez-ai vam12375/shushu-api

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
3
Acompanhando
0
Saúde
85%
Último commit
há 5 meses
Versão
deploy-mimo-international
Issues abertas
0
Contribuidores
1

Casos de uso

  • Agregar múltiplos provedores de IA em uma única interface OpenAI-compatível
  • Controlar custos e tracking de uso através de um painel centralizado
  • Implementar autenticação unificada (JWT, OAuth, Passkeys) para acesso a múltiplos modelos
  • Balancear carga entre canais e fazer failover automático entre fornecedores

Veredito

Solução robusta em Go para centralizar gerenciamento de múltiplas APIs de IA em produção. Excelente para equipes/organizações com múltiplas contas de modelo e necessidade de faturamento granular, mas requer expertise DevOps para deployment e manutenção.

README

A tradução para o português deste README ainda está na fila.

new-api

鼠鼠🐭公益站-------基于NEW-API进行二次开发

🍥 下一代 AI 网关 — 统一接入 40+ 大模型供应商

[!NOTE] 本项目是基于 NEW-API 的社区分支,由 Calcium-Ion 原始创建。 我们衷心感谢原作者及上游项目的所有贡献者奠定的坚实基础。 本分支在 AGPL v3 许可证下继续开发,由 QuantumNous 维护,增加了一系列扩展功能与改进。


📝 项目概述

New API 是一个生产级 AI API 网关,将 40+ 上游 AI 供应商聚合到统一的 OpenAI 兼容接口之下。它提供统一的身份认证、速率限制、成本核算,以及现代化的管理后台——专为需要管理多个 AI 服务账号、跨团队追踪用量、规模化控制成本的组织而设计。

[!IMPORTANT]

  • 本项目仅面向合法授权的 AI API 网关、组织内部鉴权、多模型管理、用量统计、成本核算和私有化部署场景。
  • 使用者必须合法取得上游 API Key、账号、模型服务及接口权限,并遵守上游服务条款及适用法律法规。

🚀 快速开始

Docker Compose(推荐)

git clone https://github.com/QuantumNous/new-api.git
cd new-api
docker compose up -d

部署完成后访问 http://localhost:3000 进入管理后台。

Docker 命令

# 使用 SQLite(最简模式)
docker run -d --name new-api \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  quantumnous/new-api:latest

# 使用 MySQL / PostgreSQL
docker run -d --name new-api \
  -p 3000:3000 \
  -e SQL_DSN="root:password@tcp(host:3306)/new-api?charset=utf8mb4&parseTime=True&loc=Local" \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  quantumnous/new-api:latest

完整环境变量说明见 环境变量 章节。


✨ 主要特性

🎨 平台能力

特性说明
🖥️ 现代化后台React 19 + TypeScript + Tailwind CSS 管理控制台
🌍 多语言简体中文、English、Français、Русский、日本語、Tiếng Việt
📊 数据分析实时用量仪表盘、成本拆解、趋势图表
🔐 认证体系JWT、WebAuthn/Passkeys、OAuth(GitHub、Discord、OIDC、Telegram、微信)
🗄️ 多数据库SQLite、MySQL ≥ 5.7.8、PostgreSQL ≥ 9.6

🤖 AI 网关

特性说明
🔄 协议转换OpenAI ↔ Claude Messages ↔ Google Gemini ↔ OpenAI Responses
📡 40+ 供应商OpenAI、Claude、Gemini、AWS Bedrock、Azure、DeepSeek、通义千问、Ollama 等
🎯 智能路由加权负载均衡、故障自动切换、渠道亲和性策略
📡 流式支持SSE 流式输出,覆盖聊天、实时对话、异步任务轮询

💰 计费与成本控制

特性说明
📊 用量核算按次、按 Token、按缓存命中的精确成本追踪
🎯 分级计费基于表达式的动态定价,支持自定义公式
💳 支付集成Stripe、易支付、Creem、Waffo Pancake
🔑 额度管理用户级、分组级、Key 级的多层额度分配

🏗️ 系统架构

客户端 (OpenAI SDK / Web UI)
        │
        ▼
┌──────────────────────────────────┐
│         New API 网关               │
│  ┌─────────┐  ┌───────────────┐  │
│  │ 路由层    │  │  中间件层       │  │
│  │          │  │  认证/限流/CORS │  │
│  └────┬─────┘  └───────────────┘  │
│       │                            │
│  ┌────▼─────────────────────────┐ │
│  │     中继引擎                   │ │
│  │  OpenAI │ Claude │ Gemini ... │ │
│  └────┬─────────────────────────┘ │
│       │                            │
│  ┌────▼─────┐  ┌───────────────┐  │
│  │ 计费引擎   │  │   服务层       │  │
│  └──────────┘  └───────────────┘  │
└──────────────────────────────────┘
        │
        ▼
┌──────────────────────────────────┐
│  OpenAI · Claude · Gemini · AWS   │
│  Azure · DeepSeek · 通义千问 ...  │
│      40+ 上游 AI 供应商            │
└──────────────────────────────────┘

📡 供应商支持

供应商适配器标识支持功能
OpenAI / Azureopenai聊天、嵌入、图像、音频、视频、实时、Responses
Anthropic ClaudeclaudeMessages API、Computer Use、Citations
Google Geminigemini多模态、原生 API、Vertex AI、思考模式
AWS Bedrockaws多模型路由、IAM 凭证管理
DeepSeekdeepseekV3/R1 模型
阿里通义千问ali聊天、图像(通义万相)、Rerank
百度文心一言baidu、baidu_v2对话、插件
智谱 GLM / CogViewzhipu、zhipu_4v对话、图像生成
Moonshot (Kimi)moonshot对话
Mistral AImistral对话
Coherecohere对话、Rerank
Ollama (本地)ollama对话、流式
SiliconFlowsiliconflow对话、嵌入
OpenRouteropenrouter聚合路由
Cloudflare Workers AIcloudflare对话
xAI (Grok)xai对话
Perplexityperplexity对话
Jina AIjina嵌入、Rerank
讯飞星火xunfei对话
字节跳动火山引擎volcengine对话、TTS
腾讯云tencent对话
Minimaxminimax对话、图像、TTS
零一万物lingyiwanwu对话
360 AIai360对话
即梦 (字节)jimeng图像生成
Mimomimo视频
MOKA AImokaai对话
DifydifyChatFlow
Cozecoze对话
Replicatereplicate模型托管
Google PaLMpalm对话
Xorbits Inferencexinference本地推理
子模型委托submodel转发代理
异步任务taskSuno、Sora、Kling、Hailuo、Vidu
CodexcodexOAuth 访问

🚢 部署

环境要求

组件要求
数据库SQLite(默认)、MySQL ≥ 5.7.8 或 PostgreSQL ≥ 9.6
缓存Redis(推荐)或内存缓存
运行时Docker / Docker Compose,或 Go 1.25+

环境变量

变量名说明默认值
SESSION_SECRET会话加密密钥(多机部署必须设置)—
CRYPTO_SECRET数据加密密钥(共享 Redis 必须设置)—
SQL_DSN数据库连接字符串SQLite data/new-api.db
REDIS_CONN_STRINGRedis 连接字符串 (redis://host:port)—
STREAMING_TIMEOUTSSE 流式超时(秒)300
STREAM_SCANNER_MAX_BUFFER_MB流式扫描器单行最大缓冲(MB)64
MAX_REQUEST_BODY_MB请求体最大体积(MB,解压后计)32
AZURE_DEFAULT_API_VERSIONAzure API 默认版本2025-04-01-preview
TZ容器时区Asia/Shanghai
ERROR_LOG_ENABLED启用详细错误日志false

生产环境检查清单

[!WARNING]

  • 生产环境必须设置 SESSION_SECRET,否则多实例登录状态不一致
  • 共享 Redis 时必须设置 CRYPTO_SECRET,否则加密数据无法跨实例解密
  • 生产环境建议使用 Nginx/Caddy 反向代理进行 TLS 终止
  • Docker 部署时务必挂载 /data 为持久化卷

🔗 相关项目

项目说明
NEW-API上游项目(本项目为其分支)
One API原始项目(MIT 许可证)
Midjourney-ProxyMidjourney 接口集成

📜 许可证

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

本项目是基于 NEW-API 的开源分支,NEW-API 本身源自 One API(MIT 许可证)。

如果贵组织的政策不允许使用 AGPL v3 许可的软件,或希望规避 AGPL v3 的开源义务,请联系:support@quantumnous.com


💖 感谢使用 New API

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

发行版 • 问题反馈 • 讨论区

Built with ❤️ by QuantumNous

Ver o original no GitHub

Bom para

Relacionados