OpenAI 兼容 · Vercel Edge · 开源

AI Relay

轻量级开源 AI API 中转服务

把多个 Provider、多把 Key、Fallback、用量统计和 Admin 后台收进一个透明代理。客户端继续用 OpenAI 接口，团队获得更稳的模型入口。

快速开始 GitHub Deploy with Vercel

100%OpenAI 兼容

2 minVercel 一键部署

Edge低延迟代理

FEATURES

中转服务该有的稳定性，一次配齐

从请求入口到 Provider、Key Pool、Fallback 和告警，AI Relay 负责把不稳定的上游变成稳定的统一接口。

多 Key 轮换

Round-Robin 分发请求，遇到 429 自动退避，降低单 Key 限流风险。

多 Provider 路由

支持 OpenAI、Claude、DeepSeek、MiMo 与自定义 Provider，按模型前缀自动路由。

多级 Fallback

Provider 到 Key Pool 的链式故障转移，让上游异常不直接暴露给客户端。

100% OpenAI 兼容

保留 /v1/chat/completions 与 /v1/models 习惯，现有 SDK 几乎零改动接入。

Admin 后台

集中管理密钥、配额、用量统计、模型测试和 Provider 配置。

一键部署

面向 Vercel Edge Runtime 设计，免费层也能快速跑起个人或团队中转站。

QUICK START

四步部署并开始调用

沿用 README 的最短路径：先部署，再验证健康状态，进入 Admin 添加 Provider Key，最后直接调用 OpenAI 兼容接口。

部署

用 Vercel 克隆仓库，填入 RELAY_API_KEY、RELAY_ADMIN_KEY、RELAY_SIGNING_SECRET。

Deploy with Vercel

Vercel

RELAY_API_KEY=your-strong-client-key
RELAY_ADMIN_KEY=your-admin-key
RELAY_SIGNING_SECRET=your-signing-secret

验证

部署完成后检查公开健康端点，确认 Edge Function 已经正常响应。

bash

curl https://你的项目.vercel.app/health
# {"status":"ok"}

添加密钥

进入 Admin 后台，添加 OpenAI、Claude、DeepSeek、MiMo 或自定义 Provider Key。

URL

https://你的项目.vercel.app/admin
# 使用 RELAY_ADMIN_KEY 登录

开始调用

把客户端 base URL 指向你的 Relay，继续使用 OpenAI 兼容请求格式。

bash

curl -X POST https://你的项目.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer YOUR_RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好！"}]}'

API

精简但完整的 OpenAI 兼容端点

端点	说明	访问
`GET /v1/models`	列出所有可用模型	Bearer Key
`GET /v1/models/:id`	查询单个模型信息	Bearer Key
`POST /v1/chat/completions`	Chat Completions，支持流式和非流式	Bearer Key
`GET /health`	公开健康检查	Public
`GET /api/status`	服务状态详情	Public

MODELS

当前实例支持的模型

模型列表来自服务端 Provider 注册表和自定义 Provider 配置，部署后会随配置动态变化。

LPGPT (GPT-5)

gpt-5.*

gpt-5.3GPT-5.3

128K流式视觉工具

gpt-5.3-codexGPT-5.3 Codex

128K流式视觉工具

gpt-5.4GPT-5.4

128K流式视觉工具

gpt-5.5GPT-5.5

128K流式视觉工具

OpenAI

gpt-, o1-, o3-, o4-, chatgpt-, dall-e-*

gpt-4oGPT-4o

128K流式视觉工具

gpt-4o-miniGPT-4o Mini

128K流式视觉工具

gpt-4-turboGPT-4 Turbo

128K流式视觉工具

o1o1

200K流式工具

o1-minio1 Mini

128K流式

o3o3

200K流式视觉工具

o3-minio3 Mini

200K流式工具

o4-minio4 Mini

200K流式视觉工具

chatgpt-4o-latestChatGPT-4o Latest

128K流式视觉工具

gpt-3.5-turboGPT-3.5 Turbo

16K流式工具

Anthropic (Claude)

claude-*

claude-opus-4-20250514Claude Opus 4

200K流式视觉工具

claude-sonnet-4-20250514Claude Sonnet 4

200K流式视觉工具

claude-3-5-sonnet-20241022Claude 3.5 Sonnet

200K流式视觉工具

claude-3-5-haiku-20241022Claude 3.5 Haiku

200K流式视觉工具

claude-3-opus-20240229Claude 3 Opus

200K流式视觉工具

DeepSeek

deepseek-*

deepseek-chatDeepSeek V3

64K流式工具

deepseek-reasonerDeepSeek R1

64K流式

MiMo (API Key)

mimo-*

mimo-v2.5MiMo v2.5

128K流式视觉工具

mimo-v2.5-proMiMo v2.5 Pro

128K流式视觉工具

MiMo SGP (Coding Plan)

mimo-v2.5-pro-sgp, mimo-v2.5-flash-sgp, mimo-v2.5-sgp*

mimo-v2.5-sgpMiMo v2.5 (SGP Coding)

128K流式视觉工具

mimo-v2.5-pro-sgpMiMo v2.5 Pro (SGP Coding)

128K流式视觉工具

mimo-v2.5-flash-sgpMiMo v2.5 Flash (SGP Coding)

128K流式视觉

MiMo (Coding Plan)

mimo-v2.5-pro-coding, mimo-v2.5-coding*

mimo-v2.5-codingMiMo v2.5 (Coding)

128K流式视觉工具

mimo-v2.5-pro-codingMiMo v2.5 Pro (Coding)

128K流式视觉工具

xiaomi_tudo

mimo-v2.5-pro*

mimo-v2.5MiMo-v2.5

1M流式视觉

mimo-v2.5-proMiMo-v2.5-Pro

1M流式视觉

ARCHITECTURE

透明代理，链式故障转移

OpenAI 兼容请求进入 Relay
按模型前缀选择 Provider
Key Pool 轮换、退避、Fallback
用量、错误与配置写入 KV