LiuAIbridge
lekliu/LiuAIbridge
Gateway unificado para APIs de IA com UI admin, roda em Cloudflare
Ver no GitHubGateway de API para IA leve e seguro, deployado em Cloudflare Workers, que resolve o problema de acesso direto a APIs como Google Gemini, OpenAI e Anthropic para desenvolvedores. Oferece interface de administração visual, suporte a múltiplos modelos, compatibilidade com protocolo OpenAI e autenticação via tokens.
Instalação
npx convez-ai lekliu/LiuAIbridge1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar múltiplas APIs de IA (Gemini, OpenAI, Claude) com um único endpoint
- Gerenciar chaves de API de forma centralizada e segura via dashboard web
- Contornar limitações de acesso direto para desenvolvedores na China/regiões restritas
Veredito

Solução técnica sólida para abstração de múltiplas APIs de IA com deployment serverless. Bem estruturada para casos de uso que precisam de compatibilidade OpenAI e contorno de restrições de acesso regional, mas exige conhecimento de Cloudflare Workers e DevOps.
README
A tradução para o português deste README ainda está na fila.
🌉 LiuAIbridge
一个轻量级、安全、带 UI 的 AI API 边缘网关。
部署在 Cloudflare Workers 上,旨在解决国内开发者直连访问 Google Gemini, OpenAI, Anthropic 等 API 的痛点。
✨ 特性
- 国内直连:无需本地代理,通过 Cloudflare 全球加速。
- 可视化后台:内置
/admin仪表盘,图形化管理各平台 API Key。 - 多模型支持:统一转发 Google、OpenAI、Anthropic 请求。
- 协议分层:上游分别走 Google / Anthropic / OpenAI 官方原生或官方兼容端;下游可选用 OpenAI 形态的
POST .../v1/chat/completions(Gemini 由网关转原生 Gemini;Claude 由 Anthropic 官方 OpenAI 兼容层处理),与 原生路径(如/google/v1beta/...、/anthropic/v1/messages)通过路径区分、可同时保留。 - 统一 OpenAI 形态入口:
/compat/openai/google/...、/compat/openai/anthropic/...与/google/...、/anthropic/...等价,便于下游固定 Base URL。 - 安全加固:API Key 存储于 KV 空间,请求采用 Header 鉴权(
X-Bridge-Token或Authorization: Bearer桥接令牌)。 - 流式传输:Gemini(OpenAI 形态)由网关转换 SSE;Claude(OpenAI 形态)与 OpenAI 直连为上游 SSE 透传。
🚀 快速开始
-
部署:
wrangler kv namespace create LIU_BRIDGE_KV wrangler secret put ADMIN_TOKEN wrangler secret put BRIDGE_TOKEN wrangler deploy -
管理:访问
你的域名/admin配置 API Keys。 -
调用(桥接令牌:
X-Bridge-Token或Authorization: Bearer,值为BRIDGE_TOKEN):用途 Base / 示例 OpenAI 官方 API https://你的域名/openai/v1/...Gemini 原生 https://你的域名/google/v1beta/models/...Gemini OpenAI 形态(网关 → Gemini 原生) POST https://你的域名/google/v1/chat/completionsClaude 原生 POST https://你的域名/anthropic/v1/messagesClaude OpenAI 形态(网关 → Anthropic 官方 OpenAI 兼容 /v1/chat/completions)POST https://你的域名/anthropic/v1/chat/completions固定 compat 前缀(与上一行等价,仅路径改写) POST https://你的域名/compat/openai/google/v1/chat/completions、.../compat/openai/anthropic/v1/chat/completions说明:当前跨厂商兼容以
/v1/chat/completions(非流式 + SSE 流式)为主;/v1/responses未接入。能力边界以 各上游实际支持 及官方 OpenAI 兼容文档为准(Claude 侧兼容层 limitations 见 Anthropic OpenAI SDK compatibility)。
🛠️ 本地开发与调试 (Local Development)
在正式部署到 Cloudflare 之前,建议先在本地环境验证配置。
1. 准备环境
确保你已安装了 Node.js (推荐 LTS 版本)。
# 安装项目依赖
npm install
2. 配置本地环境变量
在项目根目录下创建一个名为 .dev.vars 的文件(Wrangler 会自动读取它作为本地 Secret):
ADMIN_TOKEN=your_admin_password_123
BRIDGE_TOKEN=your_bridge_token_456
3. 启动本地服务器
运行以下命令启动模拟环境:
npx wrangler dev
启动成功后,控制台会显示 Ready on http://localhost:8788。
4. 初始化本地数据
由于本地环境使用模拟的 KV 存储,你需要先进入后台配置 API Key:
- 在浏览器访问:
http://localhost:8788/admin。 - 输入你在
.dev.vars中设置的ADMIN_TOKEN。 - 点击 “添加新 Key”,填入你的 Gemini/OpenAI 密钥。
- 数据将保存到本地
.wrangler文件夹中。
5. 测试接口
你可以使用项目自带的 test.py 或 curl 进行验证:
PowerShell 示例:
curl.exe -X POST "http://localhost:8788/google/v1beta/models/gemini-1.5-flash:generateContent" `
-H "Content-Type: application/json" `
-H "X-Bridge-Token: your_bridge_token_456" `
-d '{"contents": [{"parts":[{"text": "你好"}]}]}'
6. 注意事项
- 网络环境:在本地调试时,Worker 运行在你自己的机器上。因此,你的电脑必须能够正常访问 Google 或 OpenAI 的 API 地址(即需要开启全局代理),否则会返回
502 Bad Gateway。 - 部署后:一旦使用
wrangler deploy发布,Worker 将运行在 Cloudflare 节点,届时无需本地代理即可实现国内直连。