One API 的保姆级搭建教程

一、 One API 是什么？有什么作用？

One API 是一款开源的 大模型接口管理与分发系统（基于 Go 语言开发）。它可以把市面上各种零散、格式各异的 AI 接口（如 OpenAI、NVIDIA NIM、DeepSeek、Claude、Gemini、智谱等）统一整合起来。

核心作用：

1. 统一格式（标准化）：将所有不同厂商的杂乱 API，全部转换为标准的 OpenAI 格式 (/v1/chat/completions)。这意味着你只需要写一套代码或配一次客户端，就能随意切换底层的 AI 模型。

2. 聚合与分发：你可以把多个不同渠道（如官方 Key、免费测压 Key、各种中转商）加到一个平台里，对外只暴露一个统一的 Key，系统会自动进行负载均衡或按优先级调用。

3. 额度与权限管理：支持多用户、多分组、设置令牌（Token）过期时间及额度限制，非常适合自建团队共享或个人多设备统一管理。

二、 One API 部署教程（Docker 方式）

使用 Docker 部署是最快、最省心的方式（推荐 Linux 服务器、NAS 或本地 Windows/Mac 的 Docker 环境）。

1. 运行部署命令

打开终端，执行以下 Docker 命令（默认使用内置的 SQLite 数据库，数据会自动持久化到宿主机）：

Bash

docker run --name one-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api

注：-p 3000:3000 表示将容器内的 3000 端口映射到宿主机的 3000 端口，可根据需要自行调整宿主机端口。

2. 登录后台

• 部署成功后，在浏览器中访问：http://你的服务器IP:3000（如果是本机测试，访问 http://localhost:3000）。

• 初始默认管理员账号：

  • 用户名：root

  • 密码：123456 (登录后请第一时间修改密码)

三、 后续配置指南（核心三步走）

部署完成后，让 One API 正常工作只需要配置三个核心板块：渠道 ➔ 令牌 ➔ 客户端对接。

第一步：添加「渠道」（告诉 One API 你的模型从哪来）

渠道就是你的上游大模型提供商（例如 OpenAI 官方、NVIDIA NIM 免费接口、DeepSeek 官方等）。

1. 登录 One API 后台，点击顶部的 「渠道」 ➔ 「添加新的渠道」。

2. 填写配置：

   • 类型：选择对应的厂商（例如 OpenAI、NVIDIA NIM、DeepSeek 等）。

   • 名称：给这个渠道起个好记的名字（如 NVIDIA-Free）。

   • 模型：勾选或填写该渠道支持的模型名称（如 nemotron-3-super-120b-a12b）。

   • 密钥 (API Key)：填入你在对应厂商官网上申请的原始 API Key。

   • 分组：保持默认的 default 即可。

3. 点击 提交 保存。

第二步：创建「令牌」（生成供你调用的统一凭证）

令牌（Token）是你提供给 Trae、Cursor、代码脚本或第三方客户端使用的“访问钥匙”。

1. 点击顶部的 「令牌」 ➔ 「添加新的令牌」。

2. 填写配置：

   • 名称：例如 trae-test。

   • 分组：必须与刚才渠道所属的分组保持一致（通常为 default）。

   • 额度：可根据需要选择“无限额度”或自定义数值。

   • 模型范围：如果不做限制，可以留空或勾选你需要允许调用的模型。

3. 点击 提交 后，在列表中点击 复制，你将获得一个形如 sk-xxxxxx... 的新密钥。

第三步：在第三方客户端（如 Trae / Cursor / 脚本）中配置

现在，你可以把 One API 当成标准的 OpenAI 接口来对接任何支持自定义大模型的软件了：

• API 基础地址 (Base URL)：http://你的服务器IP:3000/v1

• API 密钥 (API Key)：填入你在第二步中复制的 sk-xxxxxx 令牌。

• 模型名称 (Model)：填入你在第一步渠道里配置支持的具体模型名（例如 nemotron-3-super-120b-a12b）。

四、 验证是否配置成功

你可以在本地电脑的终端（CMD / Terminal）中直接用 curl 命令测试中转通道是否打通：

Bash

curl -X POST http://你的服务器IP:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的令牌sk-xxxxxx" \
  -d "{\"model\":\"nemotron-3-super-120b-a12b\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}],\"stream\":false}"

如果能正常返回 JSON 格式的 AI 回复内容，说明你的 One API 中转分发系统已经大功告成！