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

换一个地址,
就够了
过去每接一家上游,就多一份 SDK 配置、一把密钥、一张账单。现在应用只认识 xLyra。
- 这些不用再分别维护
OpenAI 官方 Keyapi.openai.comAnthropic 官方 Keyapi.anthropic.comGemini 的 Keygoogleapis.com两家中转站的余额relay-*.example.comCodex 订阅的 token 刷新OAuthClaude Code 订阅的授权OAuth
client = OpenAI(- base_url="https://api.openai.com/v1",- api_key="sk-…",+ base_url="https://your-xlyra/v1",+ api_key="<下游 API Key>",)# Anthropic SDK 同理,模型名照旧官方 API、订阅账号、中转站,
点一下就接进来
18 种接入类型,Codex、Claude Code 订阅直接授权。xLyra 负责刷新 token,在上游支持时同步额度,并在多个账号之间挑选。

某个上游出了问题,
请求会换一条路
每个请求都会给所有可用上游打分。失败的上游进入冷却,恢复后自动回到队列。
切换发生在首个字节写出之前;流式响应一旦开始,就不会再更换上游。
- 01健康
- 02延迟
- 03冷却
- 04优先级

每一次尝试都留在请求日志里:走了哪个站点、哪把上游 Key、为什么切换。
你说哪种协议,上游都听得懂
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
}每个应用一把钥匙,
每一分钱都有去处
上游凭据留在网关里,应用只拿到下游 Key。谁能用什么、能用多少、花了多少,都在一个控制台里。

- 1统一的下游地址,所有应用都指向它
- 2按模型、站点或站点组设置白名单
- 3总额、每日、每周三种额度,用完即停;每日和每周额度到期自动重置
- 4每把 Key 单独设定 RPM 与 TPM 上限
每条请求,都有完整的费用计算公式
输入、输出、缓存命中分别按价格表计价,上游 Key 倍率也算进去。估算费用按 Key、模型、站点分账,月底不用再猜。

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

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

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

看一眼,今天每把 Key 花了多少
按模型堆叠的费用趋势、用户排行、缓存命中率。哪个应用最费钱,一眼就知道。

还有这些,也替你想好了
有一台能跑 Docker 的机器,
就能装
一个镜像包含 Go 后端与 React 控制台,数据留在你自己的 PostgreSQL。
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- 一个镜像Go 后端与 React 控制台由同一个镜像提供。
- 首次访问打开控制台,创建管理员账号,即可添加第一个站点。
- 上线之前修改数据库密码,并为控制台配置 HTTPS。
常见问题
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。