cita-777/metapi

这是什么？

核心功能

• 01提供兼容 OpenAI 与 Claude 格式的接口，涵盖聊天、Responses、Embeddings 和文件等。
• 02自动发现各上游站点的模型，无需手动配置路由表。
• 03按成本、余额和使用率加权路由，支持自动故障转移与冷却。
• 04为每个账号定时执行签到并定期刷新余额。
• 05支持 Webhook、Bark、Server酱、Telegram 和 SMTP 邮件告警。
• 06以单个 Docker 容器部署，可选 SQLite、MySQL 或 PostgreSQL 存储。

适用场景

• 将多个中转站的 API Key 合并，让编辑器和聊天工具只使用一个入口。
• 为同一模型自动选择当前成本最低的可用通道。
• 在一个面板中集中追踪多个中转账号的余额和签到奖励。
• 上游站点故障时自动切换到其他通道，保持 AI 工具可用。

快速上手

1. 1

   创建项目文件夹

   mkdir metapi && cd metapi
2. 2

   按 README 内容创建 docker-compose.yml 文件

3. 3

   设置管理员令牌和代理令牌，然后启动容器

   export AUTH_TOKEN=your-admin-token && export PROXY_TOKEN=your-proxy-sk-token && docker compose up -d
4. 4

   打开 http://localhost:4000 并使用 AUTH_TOKEN 登录

使用前须知

• !README 提示：若在 Compose 外运行且未设置 AUTH_TOKEN，默认管理员令牌为 change-me-admin-token，使用前必须修改。
• !armv7l 架构仅支持服务端和 Docker 运行，不提供桌面安装包。

收录于专题

标签

常见问题

metapi 是什么？

自托管网关，把多个 AI 中转站统一为一个 API Key 和入口，自动发现模型并智能路由。 Metapi 将基于 New API、One API、OneHub、DoneHub、Veloera、AnyRouter、Sub2API 等面板搭建的多个 AI 中转站，以及部分 OpenAI、Claude、Gemini 兼容接口和 OAuth 账号统一汇聚。Cursor、Claude Code、Codex、Open WebUI 等下游工具只需连接一个代理地址，就能调用所有已发现的模型，上游新增的模型会自动出现在模型列表中。

metapi 可以免费使用吗？用的什么许可证？

metapi 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

metapi 还在维护吗？

半年内有更新。metapi 最近一次提交是在 2026年9月6日。

metapi 适合用来做什么？

将多个中转站的 API Key 合并，让编辑器和聊天工具只使用一个入口。 为同一模型自动选择当前成本最低的可用通道。 在一个面板中集中追踪多个中转账号的余额和签到奖励。 上游站点故障时自动切换到其他通道，保持 AI 工具可用。

metapi 怎么安装和运行？

创建项目文件夹: mkdir metapi && cd metapi 按 README 内容创建 docker-compose.yml 文件 设置管理员令牌和代理令牌，然后启动容器: export AUTH_TOKEN=your-admin-token && export PROXY_TOKEN=your-proxy-sk-token && docker compose up -d 打开 http://localhost:4000 并使用 AUTH_TOKEN 登录

在哪里获取 metapi？

源代码和安装说明在 GitHub 上：https://github.com/cita-777/metapi