中转站的中转站 — 将分散的 AI 中转站聚合为一个统一网关

<p> 把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点， <br> 汇聚成 <strong>一个 API Key、一个入口</strong>，自动发现模型、智能路由、成本最优。 </p> <p align="center"> <a href="https://linux.do/t/topic/1671489" alt="LINUX DO"> <img src="https://shorturl.at/ggSqS" alt="LINUX DO"> </a> </p> <p align="center"> <a href="https://github.com/cita-777/metapi/releases"> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/cita-777/metapi?label=Release&logo=github&style=flat"> </a><a href="https://github.com/cita-777/metapi/stargazers"> <img alt="GitHub Stars" src="https://img.shields.io/github/stars/cita-777/metapi?style=flat&logo=github&label=Stars"> </a><a href="https://deepwiki.com/cita-777/metapi"> <img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg"> </a><a href="https://hub.docker.com/r/1467078763/metapi"> <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/1467078763/metapi?style=flat&logo=docker&label=Docker%20Pulls"> </a><a href="https://hub.docker.com/r/1467078763/metapi"> <img alt="Docker Image" src="https://img.shields.io/badge/docker-1467078763%2Fmetapi-blue?logo=docker&style=flat"> </a><a href="LICENSE"> <img alt="License" src="https://img.shields.io/badge/license-MIT-brightgreen?style=flat"> </a><img alt="Node.js" src="https://img.shields.io/badge/Node.js-22.15%2B-339933?logo=node.js&style=flat"><img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&style=flat"><a href="https://zeabur.com/templates/DOX5PR"> <img alt="Deploy on Zeabur" src="https://zeabur.com/button.svg" height="28"> </a><a href="https://render.com/deploy?repo=https://github.com/cita-777/metapi"> <img alt="Deploy to Render" src="https://render.com/images/deploy-to-render-button.svg" height="28"> </a> </p> <p align="center"> <a href="README.md"><strong>中文</strong></a> | <a href="README_EN.md">English</a> </p> <p align="center"> <a href="https://metapi.cita777.me"><strong>📚 在线文档</strong></a> · <a href="https://metapi.cita777.me/getting-started">快速上手</a> · <a href="https://metapi.cita777.me/deployment">部署指南</a> · <a href="https://metapi.cita777.me/configuration">配置说明</a> · <a href="https://metapi.cita777.me/client-integration">客户端接入</a> · <a href="https://metapi.cita777.me/faq">常见问题</a> </p> </div>

🌐 在线体验

无需部署，直接体验 Metapi 的完整功能：

| | | | ---------------------- | ---------------------------------------------------------- | | 🔗体验地址 | metapi-t9od.onrender.com | | 🔑管理员令牌 | 123456 |

⚠️ 安全提示：体验站为公共环境，请勿填入你的 API Key、账号密码或站点信息。数据随时可能被清空。

ℹ️ 说明：体验站使用 Render 免费方案 + OpenRouter 免费模型（仅 :free 后缀的模型可用）。

📖 介绍

现在 AI 生态里有越来越多基于 New API / One API 系列的聚合中转站，要管理多个站点的余额、模型列表和 API 密钥，往往既分散又费时。

Metapi 作为这些中转站之上的元聚合层（Meta-Aggregation Layer），把多个站点统一到 一个入口（可按项目配置多个下游 API Key）——下游所有工具（Cursor、Claude Code、Codex、Open WebUI 等）即可无感接入全部模型。当前已支持以下上游平台：

New API
One API
OneHub
DoneHub
Veloera
AnyRouter — 通用路由平台
Sub2API — 订阅制中转

| 痛点 | Metapi 怎么解决 | | ------------------------------------- | ---------------------------------------------------------------------- | | 🔑 每个站点一个 Key，下游工具配置一堆 | 统一代理入口 + 可选多下游 Key 策略，模型自动聚合到 /v1/* | | 💸 不知道哪个站点用某个模型最便宜 | 智能路由 自动按成本、余额、使用率选最优通道 | | 🔄 某个站点挂了，手动切换好麻烦 | 自动故障转移，一个通道失败自动冷却并切到下一个 | | 📊 余额分散在各处，不知道还剩多少 | 集中看板 一目了然，余额不足自动告警 | | ✅ 每天得去各站签到领额度 | 自动签到 定时执行，奖励自动追踪 | | 🤷 不知道哪个站有什么模型 | 自动模型发现，上游新增模型零配置出现在你的模型列表里 |

🖼️ 界面预览

<table> <tr> <td align="center"> <img src="docs/screenshots/dashboard.png" alt="dashboard" style="width:100%;height:auto;"/> <div><b>仪表盘</b> — 余额分布、消费趋势、系统概览</div> </td> <td align="center"> <img src="docs/screenshots/model-marketplace.png" alt="model-marketplace" style="width:100%;height:auto;"/> <div><b>模型广场</b> — 跨站模型覆盖、定价对比、实测指标</div> </td> </tr> <tr> <td align="center"> <img src="docs/screenshots/routes.png" alt="routes" style="width:100%;height:auto;"/> <div><b>智能路由</b> — 多通道概率分配、成本优先选路</div> </td> <td align="center"> <img src="docs/screenshots/accounts.png" alt="accounts" style="width:100%;height:auto;"/> <div><b>账号管理</b> — 多站点多账号、健康状态追踪</div> </td> </tr> <tr> <td align="center"> <img src="docs/screenshots/sites.png" alt="sites" style="width:100%;height:auto;"/> <div><b>站点管理</b> — 上游站点配置与状态一览</div> </td> <td align="center"> <img src="docs/screenshots/tokens.png" alt="tokens" style="width:100%;height:auto;"/> <div><b>令牌管理</b> — API Token 生命周期管理</div> </td> </tr> <tr> <td align="center"> <img src="docs/screenshots/playground.png" alt="playground" style="width:100%;height:auto;"/> <div><b>模型操练场</b> — 在线交互式模型测试</div> </td> <td align="center"> <img src="docs/screenshots/checkin.png" alt="checkin" style="width:100%;height:auto;"/> <div><b>签到记录</b> — 自动签到状态与奖励追踪</div> </td> </tr> <tr> <td align="center"> <img src="docs/screenshots/proxy-logs.png" alt="proxy-logs" style="width:100%;height:auto;"/> <div><b>使用日志</b> — 代理请求日志与成本明细</div> </td> <td align="center"> <img src="docs/screenshots/monitor.png" alt="monitor" style="width:100%;height:auto;"/> <div><b>可用性监控</b> — 通道健康度实时监测</div> </td> </tr> <tr> <td align="center"> <img src="docs/screenshots/settings.png" alt="settings" style="width:100%;height:auto;"/> <div><b>系统设置</b> — 全局参数与安全配置</div> </td> <td align="center"> <img src="docs/screenshots/notification-settings.png" alt="notification-settings" style="width:100%;height:auto;"/> <div><b>通知设置</b> — 多渠道告警与推送配置</div> </td> </tr> </table>

🏛️ 架构概览

✨ 核心功能

🌐 统一代理网关

兼容 OpenAI 与 Claude 下游格式，对接所有主流客户端
支持 Responses / Chat Completions / Messages / Completions（Legacy）/ Embeddings / Images / Models，以及标准 /v1/files 文件接口
完整的 SSE 流式传输支持，自动格式转换（OpenAI ⇄ Claude）

🧠 智能路由引擎

自动发现所有上游站点的可用模型，零配置生成路由表
四级成本信号：实测成本 → 账号配置成本 → 目录参考价 → 默认兜底
多通道概率分摊，基于成本（40%）、余额（30%）、使用率（30%）加权分配
失败通道自动冷却与避让（默认 10 分钟冷却期）
请求失败自动重试，自动切换其他可用通道
路由决策可视化解释，每次选择透明可审计

<div align="center"> <img src="docs/screenshots/routes.png" alt="smart-routing-detail" width="700"/> <p><sub>智能路由配置界面 — 支持精确匹配、通配符、概率分配等多种路由策略</sub></p> </div>

📡 多平台聚合管理

| 平台 | 适配器 | 说明 | | ------------------- | ------------- | -------------------- | | New API | new-api | 新一代大模型网关 | | One API | one-api | 经典 OpenAI 接口聚合 | | OneHub | onehub | One API 增强分支 | | DoneHub | done-hub | OneHub 增强分支 | | Veloera | veloera | API 网关平台 | | AnyRouter | anyrouter | 通用路由平台 | | Sub2API | sub2api | 订阅制中转平台 |

各平台适配器覆盖模型枚举、余额查询、Token 管理、代理接入等通用能力；登录、签到、用户信息等能力按平台而异。

👥 账号与 Token 管理

多站点多账号：每个站点可添加多个账号，每个账号可持有多个 API Token
健康状态追踪：healthy / unhealthy / degraded / disabled 四级状态机
凭证加密存储：所有敏感凭证均加密保存在本地数据库中
自动续签：Token 过期时自动重新登录获取新凭证
站点联动：禁用站点自动级联禁用所有关联账号

🏪 模型广场

跨站点模型覆盖总览：哪些模型可用、多少账号覆盖、各站定价对比
延迟、成功率等实测指标展示
上游模型目录缓存与品牌分类（OpenAI、Anthropic、Google、DeepSeek 等）
交互式模型测试器，在线验证模型可用性

<div align="center"> <img src="docs/screenshots/model-marketplace.png" alt="model-marketplace-detail" width="700"/> <p><sub>模型广场 — 一站式浏览所有可用模型的覆盖率、定价和性能指标</sub></p> </div>

✅ 自动签到

Cron 定时执行（默认每日 08:00）
智能解析奖励金额，签到失败自动通知
按账号启用/禁用控制
完整签到日志与历史查询
并发锁防止重复签到

💰 余额管理

定时余额刷新（默认每小时），批量更新所有活跃账号
收入追踪：每日/累计收入与消费趋势分析
余额兜底估算：API 不可用时通过代理日志推算余额变动
凭证过期自动重新登录

🔔 告警通知

支持五种通知渠道：

| 渠道 | 说明 | | ---------------------- | ----------------- | | Webhook | 自定义 HTTP 推送 | | Bark | iOS 推送通知 | | Server酱 | 微信通知 | | Telegram Bot | Telegram 消息通知 | | SMTP 邮件 | 标准邮件通知 |

告警场景：余额不足预警、站点/账号异常、签到失败、代理请求失败、Token 过期提醒、每日摘要报告。告警冷却机制（默认 300 秒）防止重复通知。

📊 数据看板

站点余额饼图、每日消费趋势图
全局搜索（站点、账号、模型）
系统事件日志、代理请求日志（模型、状态、延迟、Token 用量、成本估算）

<div align="center"> <img src="docs/screenshots/dashboard.png" alt="dashboard-detail" width="700"/> <p><sub>数据看板 — 余额分布、消费趋势、系统健康状态一目了然</sub></p> </div>

🎮 模型操练场

交互式聊天测试，即时验证模型可用性与响应质量
选择任意路由模型，对比不同通道输出
流式 / 非流式双模式测试

<div align="center"> <img src="docs/screenshots/playground.png" alt="playground-detail" width="700"/> <p><sub>模型操练场 — 在线交互测试，验证模型可用性与响应质量</sub></p> </div>

📦 轻量部署

单 Docker 容器，默认本地数据目录部署，支持外接 MySQL / PostgreSQL 运行时数据库
Docker 镜像支持 amd64、arm64 和 armv7l（linux/arm/v7）服务端部署
数据完整导入导出，迁移无忧

🚀 快速开始

Metapi

Install / Use

README