API 代理/中转站搭建 (OneAPI)
如果你手头有多个 API Key(OpenAI, Claude, Azure, 硅基流动等),或者你想把 API 分发给团队/朋友使用并控制额度,你需要一个 **API 管理系统**。
5分钟
2025-12-26
部署运维服务器API
API 代理/中转站搭建 (OneAPI)
如果你手头有多个 API Key(OpenAI, Claude, Azure, 硅基流动等),或者你想把 API 分发给团队/朋友使用并控制额度,你需要一个 API 管理系统。
目前业界标准是 OneAPI(或其分支 NewAPI)。它能把各种乱七八糟的模型接口统一转换成 OpenAI 格式 的接口。
1. 核心功能
- 统一接口:无论你后面接的是讯飞星火、文心一言还是 Claude,对外全都伪装成 OpenAI 接口 (
/v1/chat/completions)。 - 渠道分发:支持自动负载均衡。比如你有 5 个 OpenAI Key,它会自动轮询使用,防止单个 Key 被限频。
- 额度管理:你可以创建子账号或兑换码,给团队成员分配额度(比如每人 10 刀),用完即止。
- 详细日志:记录每一次调用的消耗、IP、时间。
2. Docker 部署
OneAPI 非常轻量,且依赖极少。
# 拉取镜像
docker pull ghcr.io/songquanpeng/one-api
# 启动容器
docker run --name one-api -d --restart always -p 3000:3000 \
-e TZ=Asia/Shanghai \
-v /home/ubuntu/data/one-api:/data \
ghcr.io/songquanpeng/one-api
启动后,访问 http://你的IP:3000。
- 默认账号:
root - 默认密码:
123456
3. 配置渠道 (Channel)
- 登录后台,点击 渠道 -> 新建渠道。
- 类型:选择你的供应商(如 OpenAI, Anthropic, 阿里通义千问等)。
- 密钥:填入该供应商的真实 API Key。
- 模型:勾选该 Key 支持的模型(如
gpt-4o,claude-3-5-sonnet)。
4. 创建令牌 (Token)
- 点击 令牌 -> 添加新令牌。
- 设置额度(如 $100)和过期时间。
- 复制生成的令牌(
sk-xxxx)。
现在,你的用户就可以在任何支持 OpenAI 的软件(如 NextChat, LobeChat)里,填入你的服务器地址和这个 sk-xxx 令牌来使用所有 AI 模型了。