convez.ai
PluginIntegração & APIsAvançado
lekliu

LiuAIbridge

lekliu/LiuAIbridge

Gateway unificado para APIs de IA com UI admin, roda em Cloudflare

Ver no GitHub
InicialPluginScore · de 0 a 100

Gateway 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/LiuAIbridge

1 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

Estrelas
0
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

License Cloudflare Workers TypeScript

🌉 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 透传。

🚀 快速开始

  1. 部署:

    wrangler kv namespace create LIU_BRIDGE_KV
    wrangler secret put ADMIN_TOKEN
    wrangler secret put BRIDGE_TOKEN
    wrangler deploy
    
  2. 管理:访问 你的域名/admin 配置 API Keys。

  3. 调用(桥接令牌:X-Bridge-Token 或 Authorization: Bearer,值为 BRIDGE_TOKEN):

    用途Base / 示例
    OpenAI 官方 APIhttps://你的域名/openai/v1/...
    Gemini 原生https://你的域名/google/v1beta/models/...
    Gemini OpenAI 形态(网关 → Gemini 原生)POST https://你的域名/google/v1/chat/completions
    Claude 原生POST https://你的域名/anthropic/v1/messages
    Claude 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:

  1. 在浏览器访问:http://localhost:8788/admin。
  2. 输入你在 .dev.vars 中设置的 ADMIN_TOKEN。
  3. 点击 “添加新 Key”,填入你的 Gemini/OpenAI 密钥。
  4. 数据将保存到本地 .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 节点,届时无需本地代理即可实现国内直连。
Ver o original no GitHub

Bom para

Relacionados