One API 部署教程(下):使用指南

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 主账号”类型:选择 “DeepSeek”API Key:填入你的 DeepSeek API Key权重:100(权重越高,被选中的概率越大)状态:启用模型列表:可以选择全部模型,也可以只选需要的点击保存小技巧:如果你有多个 DeepSeek 账号,可以添加多个渠道,设置不同的权重,实现负载均衡。添加 OpenAI 渠道如果你有 OpenAI 的 API Key,也可以加进来:名称:OpenAI 主账号类型:选择 “OpenAI”API Key:填入你的 OpenAI API Key其他配置:同 DeepSeek添加其他平台One API 支持的平台很多,包括但不限于:通义千问(阿里云)文心一言(百度)讯飞星火ClaudeGemini…添加方法都一样:选择对应的类型,填入 API Key,保存即可。渠道分组(可选)如果你的渠道很多,可以用分组来管理:进入渠道管理点击分组管理创建分组,比如 “免费渠道”、“付费渠道”、“国内渠道” 等把渠道分配到不同分组这样在调用时可以指定使用某个分组的渠道,更灵活。令牌管理配置好渠道后,接下来要创建令牌。令牌是你调用 One API 的凭证。创建令牌点击顶部菜单令牌→新建令牌填写信息:名称:比如 “测试令牌”、“生产环境令牌”过期时间:可以选择永不过期,或者设置具体时间额度:可以限制这个令牌能花多少钱(可选)允许调用的模型:可以选择全部模型,也可以限制只能调用某些模型允许调用的渠道:可以选择全部渠道,也可以限制只能使用某些渠道点击创建创建完成后,会显示一个以sk-开头的令牌,一定要复制保存好,关闭页面后就看不到了。安全提示:令牌就像密码,不要泄露给别人。如果不小心泄露了,立即删除并重新创建。令牌的最佳实践建议为不同场景创建不同的令牌:开发测试:创建一个测试令牌,设置较低的额度,避免误操作花太多钱生产环境:创建正式令牌,根据需要设置额度和权限临时使用:如果只是临时用一下,可以设置较短的过期时间额度管理:给令牌设置额度是个好习惯,特别是给其他人使用时。比如:给自己用:不设额度或设高一点给朋友试用:设置 10 元额度公开项目:设置 50 元额度,用完即止这样可以有效控制成本,避免意外支出。查看使用情况在令牌管理页面,可以看到每个令牌的使用情况:已用额度剩余额度调用次数最后使用时间定期检查这些数据,及时发现异常使用。API 调用终于到最关键的部分了——怎么用代码调用 One API。基本调用格式One API 完全兼容 OpenAI 的 API 格式,所以如果你之前用过 OpenAI 的 SDK,基本上可以直接套用。请求地址:http://你的OneAPI地址/v1/chat/completions请求头:Content-Type: application/json Authorization: Bearer sk-你的令牌请求体:{