README.md

📚 Metapi 文档中心

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

返回项目主页

---

快速导航

文档	适合谁	解决的问题
🚀 快速上手	首次使用者	10 分钟完成部署与首次请求
🚢 部署指南	部署维护者	Docker Compose、反向代理、升级回滚
⚙️ 配置说明	管理员	全部环境变量、路由参数、通知渠道
🔌 客户端接入	下游应用接入者	Open WebUI、Cherry Studio、Cursor 等接入
🔧 运维手册	运维人员	备份恢复、日志排查、健康检查
❓ 常见问题	所有用户	常见报错与修复路径
📁 目录规范	开发者	项目目录组织与约定

架构概览

┌──────────────────────────────────────────────────┐
│               下游客户端                          │
│   Open WebUI / Cherry Studio / Cursor / Claude   │
│   Code / Roo Code / Kilo Code / ...              │
└───────────────────┬──────────────────────────────┘
                    │  Authorization: Bearer <PROXY_TOKEN>
                    ▼
┌──────────────────────────────────────────────────┐
│               Metapi 网关                         │
│  ┌────────────┐  ┌────────────┐  ┌────────────┐ │
│  │ 统一代理    │  │ 智能路由    │  │ 格式转换    │ │
│  │ /v1/*      │  │ 成本+余额   │  │ OpenAI⇄    │ │
│  │            │  │ +使用率     │  │ Claude     │ │
│  └────────────┘  └────────────┘  └────────────┘ │
│  ┌────────────┐  ┌────────────┐  ┌────────────┐ │
│  │ 自动签到    │  │ 余额管理    │  │ 多渠道告警  │ │
│  └────────────┘  └────────────┘  └────────────┘ │
└───────────────────┬──────────────────────────────┘
                    │
        ┌───────────┼───────────┐
        ▼           ▼           ▼
   ┌─────────┐ ┌─────────┐ ┌─────────┐
   │ New API │ │ One API │ │ Veloera │  ...
   └─────────┘ └─────────┘ └─────────┘

核心概念

• 站点 (Site)：一个上游中转站实例（如 New API、OneHub 等）
• 账号 (Account)：在某站点上注册的用户账号
• Token：账号下的 API Key，用于访问该站点的 API
• 路由 (Route)：一条模型匹配规则，如 claude-sonnet-4-6
• 通道 (Channel)：路由下的一条 Token 链路，一个路由可有多个通道
• 代理 (Proxy)：Metapi 对下游暴露的统一 API 入口

开源协作

• 📝 贡献流程：CONTRIBUTING.md
• 🛡️ 安全策略：SECURITY.md
• 📜 行为准则：CODE_OF_CONDUCT.md