One API 部署教程(三)：使用指南

导读：前面两篇讲了本地和线上部署，现在 One API 已经跑起来了，接下来就是真正的使用环节！

系列文章导航

理解核心概念

在开始之前，咱们先搞清楚几个关键概念，不然后面容易晕。

渠道（Channel）：就是你的各个 AI 平台的 API Key。比如你有 DeepSeek 的 Key、OpenAI 的 Key、通义千问的 Key，每个都是一个渠道。One API 把这些渠道统一管理起来。

令牌（Token）：这是你用来调用 One API 的凭证。你可以把令牌想象成一张”通行证”，拿着它就能通过 One API 访问后面配置的各种渠道。这样做的好处是，你的应用只需要记住一个令牌，不用管后面具体用的是哪个平台的 Key。

模型（Model）：每个 AI 平台都有很多模型，比如 DeepSeek 有 deepseek-chat、deepseek-coder，OpenAI 有 gpt-3.5-turbo、gpt-4 等等。在 One API 里，你可以统一调用这些模型，不用关心它们来自哪个平台。

简单来说：令牌 → One API → 渠道 → AI 平台。你的应用只用跟 One API 打交道，剩下的它帮你搞定。

登录管理后台

不管你是本地部署还是线上部署，访问方式都一样：

本地部署：http://localhost:3000
线上部署：https://你的域名.onrender.com

首次访问需要注册，第一个注册的用户自动成为管理员。如果系统自动创建了 root 账号：

用户名：root
密码：123456

重要提醒：登录后第一件事就是改密码！别偷懒，安全很重要。

配置渠道

渠道配置是使用 One API 的第一步，就是把你的各个 AI 平台的 API Key 添加进去。

添加 DeepSeek 渠道

DeepSeek 是目前性价比很高的选择（具体价格和接入方式可参考 DeepSeek API 实战指南），咱们先从它开始。

点击顶部菜单渠道 → 新建渠道
填写以下信息：
- 名称：随便起，比如 “DeepSeek 主账号”
- 类型：选择 “DeepSeek”
- API Key：填入你的 DeepSeek API Key
- 权重：100（权重越高，被选中的概率越大）
- 状态：启用
- 模型列表：可以选择全部模型，也可以只选需要的
点击保存

小技巧：如果你有多个 DeepSeek 账号，可以添加多个渠道，设置不同的权重，实现负载均衡。

添加 OpenAI 渠道

如果你有 OpenAI 的 API Key，也可以加进来：

名称：OpenAI 主账号
类型：选择 “OpenAI”
API Key：填入你的 OpenAI API Key
其他配置：同 DeepSeek

添加其他平台

One API 支持的平台很多，包括但不限于：

通义千问（阿里云）
文心一言（百度）
讯飞星火
Claude
Gemini
…

添加方法都一样：选择对应的类型，填入 API Key，保存即可。

渠道分组（可选）

如果你的渠道很多，可以用分组来管理：

进入 渠道管理
点击 分组管理
创建分组，比如 “免费渠道”、”付费渠道”、”国内渠道” 等
把渠道分配到不同分组

这样在调用时可以指定使用某个分组的渠道，更灵活。

令牌管理

配置好渠道后，接下来要创建令牌。令牌是你调用 One API 的凭证。

创建令牌

点击顶部菜单令牌 → 新建令牌
填写信息：
- 名称：比如 “测试令牌”、”生产环境令牌”
- 过期时间：可以选择永不过期，或者设置具体时间
- 额度：可以限制这个令牌能花多少钱（可选）
- 允许调用的模型：可以选择全部模型，也可以限制只能调用某些模型
- 允许调用的渠道：可以选择全部渠道，也可以限制只能使用某些渠道
点击创建

创建完成后，会显示一个以 sk- 开头的令牌，一定要复制保存好，关闭页面后就看不到了。

安全提示：令牌就像密码，不要泄露给别人。如果不小心泄露了，立即删除并重新创建。

令牌的最佳实践

建议为不同场景创建不同的令牌：

开发测试：创建一个测试令牌，设置较低的额度，避免误操作花太多钱
生产环境：创建正式令牌，根据需要设置额度和权限
临时使用：如果只是临时用一下，可以设置较短的过期时间

额度管理：

给令牌设置额度是个好习惯，特别是给其他人使用时。比如：

给自己用：不设额度或设高一点
给朋友试用：设置 10 元额度
公开项目：设置 50 元额度，用完即止

这样可以有效控制成本，避免意外支出。

查看使用情况

在 令牌管理 页面，可以看到每个令牌的使用情况：

已用额度
剩余额度
调用次数
最后使用时间

定期检查这些数据，及时发现异常使用。

API 调用

终于到最关键的部分了——怎么用代码调用 One API。

基本调用格式

One API 完全兼容 OpenAI 的 API 格式，所以如果你之前用过 OpenAI 的 SDK，基本上可以直接套用。

请求地址：http://你的OneAPI地址/v1/chat/completions

请求头：

1 2	Content-Type: application/json Authorization: Bearer sk-你的令牌

请求体：

{
  "model": "deepseek-chat",
  "messages": [
    {"role": "user", "content": "你好"}
  ]
}

Linux/Mac 用户：使用 curl 测试

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Windows PowerShell 用户

方法 1：使用 Invoke-RestMethod

# 第一步：定义 JSON 变量
$jsonBody = '{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}]}'

# 第二步：发送请求
Invoke-RestMethod -Uri "http://localhost:3000/v1/chat/completions" `
  -Method Post `
  -Headers @{
    "Content-Type"="application/json"
    "Authorization"="Bearer sk-你的令牌"
  } `
  -Body $jsonBody

方法 2：使用 curl.exe

curl.exe -X POST http://localhost:3000/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer sk-你的令牌" `
  -d "{\"model\":\"deepseek-chat\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

如果返回了 AI 的回复，说明配置成功！

Python 调用示例

如果你用 Python，可以用官方推荐的 openai 库：

from openai import OpenAI

# 初始化客户端
client = OpenAI(
    api_key="sk-你的令牌",
    base_url="http://localhost:3000/v1"  # 替换为你的 One API 地址
)

# 发送请求
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

# 打印回复
print(response.choices[0].message.content)

安装依赖：

1	pip install openai

Node.js 调用示例

const OpenAI = require('openai');

const openai = new OpenAI({
  apiKey: 'sk-你的令牌',
  baseURL: 'http://localhost:3000/v1'  // 替换为你的 One API 地址
});

async function main() {
  const response = await openai.chat.completions.create({
    model: 'deepseek-chat',
    messages: [
      { role: 'user', content: '你好，请介绍一下你自己' }
    ]
  });
  
  console.log(response.choices[0].message.content);
}

main();

安装依赖：

1	npm install openai

流式输出

如果需要逐字显示的效果（像 ChatGPT 那样），可以使用流式输出：

Python 示例：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="http://localhost:3000/v1"
)

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "讲个笑话"}],
    stream=True  # 开启流式输出
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Node.js 示例：

const OpenAI = require('openai');

const openai = new OpenAI({
  apiKey: 'sk-你的令牌',
  baseURL: 'http://localhost:3000/v1'
});

async function main() {
  const stream = await openai.chat.completions.create({
    model: 'deepseek-chat',
    messages: [{ role: 'user', content: '讲个笑话' }],
    stream: true
  });
  
  for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0].delta.content || '');
  }
}

main();

高级功能

模型路由

One API 最强大的功能之一就是模型路由。你可以让同一个模型请求自动分发到不同的渠道。

场景举例：

你有 3 个 DeepSeek 账号，想让请求均匀分配：

添加 3 个 DeepSeek 渠道，权重都设为 100
调用时指定 model: "deepseek-chat"
One API 会自动在这 3 个渠道间轮询分配

好处：

提高并发能力
避免单个账号超限
降低成本（可以用多个免费账号）

负载均衡策略

在 系统设置 → 通用设置 中，可以配置负载均衡策略：

轮询：按顺序依次使用各个渠道
随机：随机选择一个渠道
权重：按权重比例分配（默认）

根据你的需求选择合适的策略。

失败重试

如果某个渠道调用失败，One API 可以自动尝试其他渠道。

在 系统设置 中开启 自动重试，设置重试次数。这样即使某个渠道暂时不可用，也不会影响整体服务。

配额管理

可以给不同用户设置不同的配额：

进入 用户管理
编辑用户
设置配额（单位：美元）

配额用完后，该用户无法继续调用，除非增加配额。这对于多用户场景很有用。

结语

到这里，One API 的基本使用方法就介绍完了。从配置渠道、创建令牌，到 API 调用，整个流程其实并不复杂。

关键是多实践，遇到问题多看日志，慢慢就熟悉了。One API 的功能远不止这些，还有用户管理、分组管理、统计报表等高级功能，等你熟练掌握基础后，可以自己探索。

希望这篇文章能帮到你。如果有任何问题，欢迎在评论区交流~

One API 配好的 Key 可以直接对接 CC GUI 插件在 IDEA 里用 Claude Code，告别终端切来切去。