forked from boos/BoosAPI
24f4b4aa56
*Total -- 13,493.63kb -> 8,824.35kb (34.6%) /docs/screenshots/account-balance.png -- 152.01kb -> 86.31kb (43.22%) /docs/logos/drafts/logo1.png -- 5,242.26kb -> 3,141.12kb (40.08%) /docs/screenshots/token-management.png -- 156.86kb -> 97.87kb (37.61%) /docs/logos/logo.png -- 123.83kb -> 77.82kb (37.15%) /docs/logos/logo-icon-128.png -- 34.64kb -> 21.89kb (36.81%) /docs/logos/logo-icon-512.png -- 477.52kb -> 308.22kb (35.45%) /src/web/public/logo.png -- 477.52kb -> 308.22kb (35.45%) /docs/logos/drafts/logo2.png -- 1,789.13kb -> 1,186.45kb (33.69%) /docs/logos/drafts/logo3.png -- 1,230.31kb -> 844.78kb (31.34%) /docs/logos/logo-icon-64.png -- 9.81kb -> 6.77kb (30.99%) /docs/screenshots/accounts.png -- 474.50kb -> 328.72kb (30.72%) /docs/screenshots/dashboard.png -- 680.18kb -> 473.10kb (30.44%) /docs/screenshots/model-marketplace.png -- 566.33kb -> 394.13kb (30.41%) /docs/screenshots/routes.png -- 598.34kb -> 419.06kb (29.96%) /docs/logos/logo-banner.png -- 94.92kb -> 67.79kb (28.58%) /docs/screenshots/account-management.png -- 680.25kb -> 496.13kb (27.07%) /docs/logos/logo-banner-sm.png -- 31.83kb -> 23.79kb (25.26%) /docs/logos/logo-full.png -- 121.20kb -> 90.99kb (24.92%) /docs/screenshots/allapi-hub-backup.png -- 193.06kb -> 145.82kb (24.47%) /docs/screenshots/site-management.png -- 78.36kb -> 61.36kb (21.7%) /docs/logos/logo-full-sm.png -- 40.96kb -> 32.34kb (21.06%) /src/web/public/favicon-64.png -- 5.31kb -> 4.31kb (18.96%) /docs/logos/logo-icon-32.png -- 2.84kb -> 2.32kb (18.11%) /docs/screenshots/account-credentials.png -- 231.67kb -> 205.04kb (11.5%) Signed-off-by: ImgBotApp <ImgBotHelp@gmail.com>
📚 Metapi 文档中心
中转站的中转站 — 将分散的 AI 中转站聚合为一个统一网关
文档站运行
npm run docs:dev
构建静态站点:
npm run docs:build
快速导航
| 文档 | 适合谁 | 解决的问题 |
|---|---|---|
| 🚀 快速上手 | 首次使用者 | 10 分钟完成部署与首次请求 |
| 🚢 部署指南 | 部署维护者 | Docker Compose、反向代理、升级回滚 |
| ⚙️ 配置说明 | 管理员 | 全部环境变量、路由参数、通知渠道 |
| 🔌 客户端接入 | 下游应用接入者 | Open WebUI、Cherry Studio、Cursor 等接入 |
| 🔧 运维手册 | 运维人员 | 备份恢复、日志排查、健康检查 |
| ❓ 常见问题 | 所有用户 | 常见报错与修复路径 |
| 🧩 FAQ/教程贡献规范 | 社区贡献者 | 统一沉淀 FAQ、教程与排障经验 |
| 📁 目录规范 | 开发者 | 项目目录组织与约定 |
架构概览
下游客户端(Cursor · Claude Code · Codex · Open WebUI · Cherry Studio 等)
↓ Authorization: Bearer <PROXY_TOKEN>
Metapi 网关
• 统一代理 /v1/* — 兼容 OpenAI / Claude 全接口
• 智能路由引擎 — 按成本、余额、可用率加权选路,失败自动冷却与重试
• 模型发现 — 自动聚合上游全部模型,零配置
• 格式转换 — OpenAI ⇄ Claude 双向透明转换
• 自动签到 · 余额管理 · 告警通知 · 数据看板
↓
上游平台(New API · One API · OneHub · DoneHub · Veloera · AnyRouter · Sub2API …)
核心概念
- 站点 (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