UniAPI - OpenAI API转发器

UniAPI是一个兼容OpenAI协议的API转发器，允许用户管理多个API密钥并在请求时根据模型随机选择合适的密钥。

效果展示

添加配置

配置列表

vercel环境变量

功能特点

支持OpenAI API和兼容OpenAI协议的其他服务 (如Azure OpenAI, Claude API等)
自定义API密钥、Base URL和模型列表
支持模型映射，可以使用统一的模型名称映射到不同厂商的实际模型
请求时根据模型自动随机选择API密钥
支持流式和非流式输出
标准Bearer Token认证，与OpenAI API完全兼容
在Vercel上轻松部署
安全的管理员登录系统，保护您的API配置

安装和使用

Vercel部署

Fork此仓库
在Vercel上创建新项目并导入该仓库
配置环境变量：
- ADMIN_API_KEY: 管理员API密钥，用于访问管理面板（必须设置）
- TEMP_API_KEY_ONE 和 TEMP_API_KEY: 配置2个允许访问的API密钥
- REDIS_URL: Redis连接URL（如果要持久化存储配置）
- ENVIRONMENT: 设置为production以禁用开发模式下的默认API密钥
- TIMEOUT_SECONDS：HTTP调用超时时间，默认60s

部署完成后，你将获得一个Vercel提供的URL。

安全访问

为了保护您的API配置不被未授权访问，所有请求都需要包含有效的API密钥。API密钥需要使用OAuth Bearer Token格式在授权头中提供：

Authorization: Bearer your_api_key

您可以通过环境变量TEMP_API_KEY_ONE和TEMP_API_KEY配置最多2个额外的API密钥，这些密钥可以用于调用API但不能访问管理面板。管理员API密钥可以通过环境变量ADMIN_API_KEY设置，默认值为adminadmin。

API使用说明

支持的端点

当前版本仅支持以下端点:

POST /v1/chat/completions - 创建聊天完成

请求参数

请求参数与OpenAI官方API一致，主要包括：

model: 要使用的模型名称
messages: 消息数组，包含role和content
temperature: 温度参数，控制随机性
max_tokens: 生成的最大token数
stream: 是否使用流式输出

示例请求

curl https://your-vercel-url.vercel.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

模型映射功能

UniAPI支持模型映射，允许您使用统一的模型名称映射到不同厂商的实际模型。例如，您可以将 gpt-4 映射到不同厂商的相应模型，然后在请求中使用 gpt-4 作为模型名称，系统会自动处理映射。

本地运行

克隆仓库

git clone https://github.com/yourusername/uniapi.git
cd uniapi

安装依赖

pip install -r requirements.txt

设置环境变量（可选，开发模式下有默认值）

# Windows PowerShell
$env:TEMP_API_KEY_ONE="your_api_key_1"
$env:TEMP_API_KEY="your_api_key_2"
$env:ADMIN_API_KEY="your_admin_key"  # 默认为 "adminadmin"

# Linux/macOS
export TEMP_API_KEY_ONE="your_api_key_1"
export TEMP_API_KEY="your_api_key_2"
export ADMIN_API_KEY="your_admin_key"  # 默认为 "adminadmin"

运行服务

python main.py

服务将在 http://localhost:8000 上运行。

角色与权限

UniAPI有两种类型的API密钥：

管理员API密钥（ADMIN_API_KEY）:
- 可以访问管理面板
- 可以管理API配置和模型映射
- 可以调用API
普通API密钥（TEMP_API_KEY_ONE和TEMP_API_KEY）:
- 只能调用API
- 不能访问管理面板
- 不能管理API配置和模型映射

本地测试

在本地测试时，可以使用以下方法：

访问管理界面：
- 打开浏览器访问 http://localhost:8000
- 使用管理员API密钥登录（默认为 adminadmin）
调用API:
- 使用curl或其他HTTP客户端
- 支持的端点: /v1/chat/completions
- 使用临时API密钥（在非生产环境）：temp_api_key或temp_api_key_one

# 测试聊天完成
curl -X POST http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer temp_api_key" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "你好"}]
  }'

在应用程序中配置:
- 将您的OpenAI客户端库指向 http://localhost:8000
- 使用临时API密钥作为认证令牌
- 注意：当前版本只支持 /v1/chat/completions 端点

许可证

本项目采用 Apache License 2.0 许可证。详情见LICENSE文件。

License

ourines/uni-api

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages