v1.19.0 · 开源 · 自托管 · AGPL-3.0

xLyra — 开源多站点 AI 网关

把官方 API、订阅账号和各家中转站收进一个入口。你的应用只认一个地址,路由、协议转换和成本估算交给 xLyra。

xlyra.example.com / 实时流图
实时流量
18+种上游接入类型
4种文本协议任意互转
1个下游地址
9+个网关端点
01ONE ENDPOINT

换一个地址,
就够了

过去每接一家上游,就多一份 SDK 配置、一把密钥、一张账单。现在应用只认识 xLyra。

  • 这些不用再分别维护
  • OpenAI 官方 Keyapi.openai.com
  • Anthropic 官方 Keyapi.anthropic.com
  • Gemini 的 Keygoogleapis.com
  • 两家中转站的余额relay-*.example.com
  • Codex 订阅的 token 刷新OAuth
  • Claude Code 订阅的授权OAuth
client.py−2 / +2
client = OpenAI(-   base_url="https://api.openai.com/v1",-   api_key="sk-…",+   base_url="https://your-xlyra/v1",+   api_key="<下游 API Key>",)# Anthropic SDK 同理,模型名照旧
要维护的入口6 → 1
Sites · OAuth

官方 API、订阅账号、中转站,
点一下就接进来

18 种接入类型,Codex、Claude Code 订阅直接授权。xLyra 负责刷新 token,在上游支持时同步额度,并在多个账号之间挑选。

新增站点:官方接入与中转接入的类型列表
02ROUTING

某个上游出了问题,
请求会换一条路

每个请求都会给所有可用上游打分。失败的上游进入冷却,恢复后自动回到队列。

POST/v1/messagesclaude-sonnet-5-5来自 Cursor 工作站
Claude 官方priority 3 · 410ms
—
中转站 Novapriority 2 · 520ms
—
中转站 Alphapriority 1 · 成功率 51%
—

切换发生在首个字节写出之前;流式响应一旦开始,就不会再更换上游。

  • 01健康
  • 02延迟
  • 03冷却
  • 04优先级
请求日志:每条请求的模型、下游密钥、站点、状态与耗时

每一次尝试都留在请求日志里:走了哪个站点、哪把上游 Key、为什么切换。

Protocols

你说哪种协议,上游都听得懂

Chat Completions、Responses、Anthropic Messages 与 Gemini 之间任意互转。选一种下游协议看看:

下游 · CHAT COMPLETIONSPOST /v1/chat/completions
{
  "model": "claude-sonnet-5-5",
  "messages": [
    { "role": "system", "content": "你是助手" },
    { "role": "user", "content": "你好" }
  ],
  "stream": true
}
上游 · Claude 官方 · ANTHROPIC MESSAGESPOST https://api.anthropic.com/v1/messages
{
  "model": "claude-sonnet-5-5",
  "system": "你是助手",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "你好" }
  ],
  "stream": true
}
03CONTROL

每个应用一把钥匙,
每一分钱都有去处

上游凭据留在网关里,应用只拿到下游 Key。谁能用什么、能用多少、花了多少,都在一个控制台里。

API 密钥列表:额度、限流与状态
  1. 1统一的下游地址,所有应用都指向它
  2. 2按模型、站点或站点组设置白名单
  3. 3总额、每日、每周三种额度,用完即停;每日和每周额度到期自动重置
  4. 4每把 Key 单独设定 RPM 与 TPM 上限
Billing

每条请求,都有完整的费用计算公式

输入、输出、缓存命中分别按价格表计价,上游 Key 倍率也算进去。估算费用按 Key、模型、站点分账,月底不用再猜。

请求详情:用量与费用计算公式
04A DAY WITH XLYRA

xLyra 的一天

09:30上班

Cursor 和 Claude Code,指向同一个地址

团队里有人用 Cursor,有人用 Claude Code。它们配置的都是 xLyra 的地址和各自的下游 Key,背后用哪个上游、哪个账号,由网关决定。

控制台界面:请求实际使用的站点与模型
14:20午后

官方限流了,没有人发现

Claude 官方返回 429,请求在首字节之前切到中转站 Nova。被限流的 Key 进入冷却,恢复后自动回到队列。

实时流图:下游应用经网关流向各上游站点
18:00下班前

客服机器人的额度用完了

它的 Key 只配了 $50 的额度,用完这把 Key 就停,不会吃掉别的应用的预算。每日和每周额度还会到期自动重置。

API 密钥的额度使用情况
23:30睡前

看一眼,今天每把 Key 花了多少

按模型堆叠的费用趋势、用户排行、缓存命中率。哪个应用最费钱,一眼就知道。

控制台:用量与费用趋势
05DETAILS

还有这些,也替你想好了

模型映射硬映射、软映射与通配兜底,对外模型名保持稳定。
流量拓扑图下游应用、网关、上游站点之间的实时请求流。
Playground在控制台里直接对话、出图,验证路由是否符合预期。
WebSocket ResponsesResponses API 的 WebSocket 传输同样走网关。
图片 · 向量 · 语音图片生成与编辑、Embeddings、TTS 都是同一个入口。
S3 兼容备份配置与数据定期备份到任意 S3 兼容存储。
TOTP 双因素控制台登录支持动态口令。
审计日志管理员的每一次修改操作都有记录。
06DEPLOY

有一台能跑 Docker 的机器,
就能装

一个镜像包含 Go 后端与 React 控制台,数据留在你自己的 PostgreSQL。

$ curl -O https://raw.githubusercontent.com/Yachiiiiyo/xLyra/main/docker-compose.yml
$ docker compose up -d
✔ Container xlyra-postgres Started
✔ Container xlyra Started
→ 打开 http://your-server:5801 创建管理员账号
docker-compose.yml
1services:2  postgres:3    image: postgres:17-alpine4    container_name: xlyra-postgres5    restart: unless-stopped6    environment:7      POSTGRES_DB: xlyra8      POSTGRES_USER: xlyra9      POSTGRES_PASSWORD: postgres_password10    volumes:11      - ./postgres:/var/lib/postgresql/data12    networks:13      - xlyra1415  xlyra:16    image: yachiiiiyo/xlyra:latest17    container_name: xlyra18    restart: unless-stopped19    depends_on:20      - postgres21    environment:22      DB_HOST: postgres23      DB_NAME: xlyra24      DB_USER: xlyra25      DB_PASSWORD: postgres_password26    volumes:27      - ./data:/data28    ports:29      - "5801:5801"30    networks:31      - xlyra3233networks:34  xlyra:35    driver: bridge
公开部署前,先替换数据库密码,并为控制台配置 HTTPS。查看仓库中的最新配置 →
  • 一个镜像Go 后端与 React 控制台由同一个镜像提供。
  • 首次访问打开控制台,创建管理员账号,即可添加第一个站点。
  • 上线之前修改数据库密码,并为控制台配置 HTTPS。
云服务器公网部署,配好 HTTPS 即可对外
NAS群晖、Unraid 等自带的 Docker
公司内网给团队一个统一出口
本机开发调试时先跑起来看看
07FAQ

常见问题

xLyra 是什么?

xLyra 是开源的 AI 网关与控制平面。它位于你的应用与各家 AI 上游之间,向应用提供统一的 OpenAI / Anthropic 兼容接口,并负责路由、协议转换、限流、成本估算和故障转移。

接入 xLyra 需要改代码吗?

通常不需要。把现有 OpenAI 或 Anthropic SDK 的 base URL 指向 xLyra,并换用在控制台颁发的下游 API Key 即可。

xLyra 支持哪些上游?

当前提供 18 种接入类型:OpenAI、Anthropic Claude、Google Gemini、OpenCode Go、DeepSeek、MiniMax、Xiaomi MiMo、Moonshot、Kimi Code、GLM、GLM Code、TypeSafe;Grok 通过 xAI 设备授权接入;NewAPI 与 xLyra 可作为级联或聚合站点;另支持 Codex OAuth、Antigravity OAuth 和 Claude Code OAuth 账号。

上游出错时,请求会自动切换吗?

会。路由引擎综合健康度、延迟、冷却状态和优先级为每个上游评分,失败后自动切换到下一个。切换只在首个字节写出之前进行;流式响应一旦开始,就不会再更换上游。

我的数据保存在哪里?

xLyra 由你自行部署。站点凭据、请求日志和用量数据保存在你自己的 PostgreSQL 中,并支持 S3 兼容备份。

如何部署 xLyra?

使用 Docker Compose 启动 xLyra 与 PostgreSQL,然后打开控制台创建管理员账号。公开部署前,请修改数据库密码,并配置 HTTPS、反向代理与访问控制。

为什么不直接调用每家模型 API?

直接调用意味着分别维护协议、密钥、限流、故障处理和账单。xLyra 把这些集中到一个网关:应用只需要认识一个地址,其余交给控制面。

xLyra 使用什么开源许可?

xLyra 以 AGPL-3.0 许可开源,源码托管在 GitHub。

把所有上游,
收进一个入口

开源,自行部署,兼容你现有的 SDK。

ONE ENDPOINT · EVERY MODEL