支持 ChatGLM 与文心一言的 API 管理镜像部署指南
1. 背景与需求
在项目中同时调用多个大模型(如文心一言、ChatGLM、通义千问等)时,常面临以下问题:
- 每个模型需单独配置
api_key、base_url、请求头格式及流式开关逻辑; - 不同环境切换模型时,因字段命名差异(如
temperaturevstop_p)导致报错; - 密钥过期或泄露难以追踪具体服务。
解决方案是引入统一的 API 网关层。该镜像将所有主流大模型的差异封装,对外暴露标准 OpenAI API 接口。业务代码无需修改即可切换后端模型,并内置密钥管理、流量控制、额度审计等功能。
2. 三步完成部署
以 Linux 服务器(Ubuntu/CentOS)为例,全程耗时约 3 分钟。
2.1 拉取并启动镜像
# 一行命令拉取并后台运行(使用默认端口 3000)
docker run -d \
--name one-api \
-p 3000:3000 \
-v /path/to/one-api-data:/app/data \
--restart=always \
registry.cn-hangzhou.aliyuncs.com/one-api/one-api:latest
说明:
-v参数将容器内数据目录挂载到宿主机,确保重启后配置不丢失;--restart=always让容器随系统自启。
等待 10 秒后,执行:
docker logs one-api | grep "Server is running"
看到类似 Server is running on http://localhost:3000 即表示启动成功。
2.2 首次登录与安全加固
打开浏览器,访问 http://你的服务器 IP:3000。
重要提醒:首次必须用 root 用户登录,初始密码为 123456。
登录后第一件事:立即修改密码。点击右上角头像 → '修改密码',设置强密码。否则任何知道 IP 的人都能接管 API 网关。
2.3 添加文心一言渠道
进入左侧菜单【渠道管理】→ 点击【+ 新建渠道】:
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 渠道名称 | 百度文心一言 | 自定义,便于识别 |
| 渠道类型 | 文心一言 | 下拉选择 |
| API Key | your_ernie_api_key | 从百度千帆控制台获取的 SK 密钥 |
| Base URL | https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro | 文心一言官方 V3 接口地址 |
| 模型名称 | ernie-4.5-turbo | 填你实际开通的模型 |
点击【保存】。若显示绿色对勾,说明接入成功。
2.4 创建令牌并调用
进入【令牌管理】→ 【+ 新建令牌】:

