Metapi

在 AI 生态日益碎片化的今天，管理分散在 New API、One API、OneHub 等多个中转站的余额、密钥和模型成为一大痛点。Metapi 作为一个“中转站的中转站”（元聚合层），它将所有上游站点汇聚为一个统一的 API 入口。通过智能路由、自动签到及集中看板，Metapi 让下游工具（如 Cursor、Claude Code、Codex）能够无感接入全部模型，实现成本最优与高可用性的完美平衡。

核心亮点：统一、智能、自动化

1. 统一代理网关

• 多源聚合：支持 New API, One API, OneHub, DoneHub, Veloera, AnyRouter, Sub2API 等主流聚合面板，以及阿里云、智谱、DeepSeek 等官方预设。
• 格式兼容：完美兼容 OpenAI 与 Claude 下游格式，支持 Chat Completions, Messages, Embeddings, Images 等接口，并自动进行 SSE 流式传输与格式转换。
• OAuth 集成：支持 Codex, Claude, Gemini CLI 等 OAuth 连接，简化认证流程。

2. 智能路由引擎

• 成本最优：基于四级成本信号（实测成本 → 账号配置 → 目录参考价 → 默认兜底）自动选择最便宜的通道。
• 概率分摊：根据成本 (40%)、余额 (30%)、使用率 (30%) 加权分配请求，避免单点过载。
• 故障转移：通道失败自动冷却（默认 10 分钟）并切换至下一可用节点，支持自动重试，确保服务高可用。
• 透明审计：每次路由决策均可视化解释，便于追踪与优化。

3. 全自动运维管理

• 自动签到：Cron 定时执行每日签到，智能解析奖励金额，失败自动通知。
• 余额监控：每小时刷新余额，支持收入/消费趋势分析，余额不足或凭证过期自动告警。
• 模型发现：自动同步上游新增模型，零配置更新本地模型列表，支持交互式测试验证。

4. 集中看板与告警

• 全局视野：站点余额饼图、消费趋势、模型覆盖率及延迟/成功率实测指标一目了然。
• 多通道告警：支持 Webhook, Bark, Server酱, Telegram, SMTP 邮件五种通知渠道，覆盖余额异常、签到失败、Token 过期等场景。

支持的上游生态

快速开始：Docker 一键部署

1. 🐳 Docker Compose (推荐)

# docker-compose.yml
services:
  metapi:
    image: 1467078763/metapi:latest
    ports:
      - "4000:4000"
    volumes:
      - ./data:/app/data
    environment:
      AUTH_TOKEN: ${AUTH_TOKEN:?AUTH_TOKEN is required} # 管理后台登录令牌
      PROXY_TOKEN: ${PROXY_TOKEN:?PROXY_TOKEN is required} # 下游调用 Token
      CHECKIN_CRON: "0 8 * * *" # 每日 8:00 自动签到
      BALANCE_REFRESH_CRON: "0 * * * *" # 每小时刷新余额
      PORT: ${PORT:-4000}
      DATA_DIR: /app/data
      TZ: ${TZ:-Asia/Shanghai}
    restart: unless-stopped

启动命令：

export AUTH_TOKEN=your-secure-admin-token
export PROXY_TOKEN=your-secure-proxy-sk-token
docker compose up -d

2. 🚀 一行 Docker 命令

docker run -d --name metapi \
  -p 4000:4000 \
  -e AUTH_TOKEN=your-secure-admin-token \
  -e PROXY_TOKEN=your-secure-proxy-sk-token \
  -e TZ=Asia/Shanghai \
  -v ./data:/app/data \
  --restart unless-stopped \
  1467078763/metapi:latest

• 访问地址：http://localhost:4000
• 登录令牌：使用设置的 AUTH_TOKEN 登录管理后台。
• 下游配置：在 Cursor/Claude Code 等工具中，Base URL 设为 http://localhost:4000/v1，API Key 设为 PROXY_TOKEN。

Metapi 是 AI 重度用户的终极基础设施。它不仅解决了多站点管理的混乱局面，更通过智能算法实现了成本与稳定性的双重优化。无论是个人开发者还是小型团队，Metapi 都能让你从繁琐的密钥切换中解放出来，专注于创造本身。