视频教程
OneAPI介绍
最近DeepSeek大模型的热度持续攀升,导致其官网API一直处于供不应求的状态,至今(2025-02-11)也没有完全恢复。
虽然许多云服务大厂如硅基流动、阿里云、字节跳动等都已经部署了DeepSeek的API,但通过这么多渠道使用起来依然不够便捷。
今天,我要向大家推荐一个非常实用的开源项目——OneAPI。
它就如同一个万能适配器,能够将众多不同供应商的API统一转换为OpenAI的API格式,并且还支持API聚合和负载均衡,通过统一管理和聚合API,OneAPI让开发者能够更加灵活、高效地使用多种大模型。无论你是个人开发者还是企业用户,OneAPI都能让你轻松管理多种大模型API。OneAPI的支持非常广泛,支持docker部署、宝塔面板/1Panel面板部署、甚至支持可执行文件直接部署,支持Windows、Linux、Mac系统。对于小白,OneAPI甚至在Gitee上有仓库,上手难度极低。实际上,当前很多售卖API的网站,其底层服务都是用OneAPI来驱动的。
GitHub仓库:songquanpeng/one-api: LLM API 管理 & 分发系统
Gitee仓库:qgw/one-api
官方readme的介绍
One API
✨ 通过标准的 OpenAI API 格式访问所有的大模型,开箱即用 ✨
部署教程 · 使用方法 · 意见反馈 · 截图展示 · 在线演示 · 常见问题 · 相关项目 · 赞赏支持
功能
支持多种大模型:
- OpenAI ChatGPT 系列模型(支持 Azure OpenAI API)
- Anthropic Claude 系列模型 (支持 AWS Claude)
- Google PaLM2/Gemini 系列模型
- Mistral 系列模型
- 字节跳动豆包大模型
- 百度文心一言系列模型
- 阿里通义千问系列模型
- 讯飞星火认知大模型
- 智谱 ChatGLM 系列模型
- 360 智脑
- 腾讯混元大模型
- Moonshot AI
- 百川大模型
- MINIMAX
- Groq
- Ollama
- 零一万物
- 阶跃星辰
- Coze
- Cohere
- DeepSeek
- Cloudflare Workers AI
- DeepL
- together.ai
- novita.ai
- 硅基流动 SiliconCloud
- xAI
支持配置镜像以及众多第三方代理服务。
支持通过负载均衡的方式访问多个渠道。
支持 stream 模式,可以通过流式传输实现打字机效果。
支持多机部署,详见此处。
支持令牌管理,设置令牌的过期时间、额度、允许的 IP 范围以及允许的模型访问。
支持兑换码管理,支持批量生成和导出兑换码,可使用兑换码为账户进行充值。
支持渠道管理,批量创建渠道。
支持用户分组以及渠道分组,支持为不同分组设置不同的倍率。
支持渠道设置模型列表。
支持查看额度明细。
支持用户邀请奖励。
支持以美元为单位显示额度。
支持发布公告,设置充值链接,设置新用户初始额度。
支持模型映射,重定向用户的请求模型,如无必要请不要设置,设置之后会导致请求体被重新构造而非直接透传,会导致部分还未正式支持的字段无法传递成功。
支持失败自动重试。
支持绘图接口。
支持 Cloudflare AI Gateway,渠道设置的代理部分填写
https://gateway.ai.cloudflare.com/v1/ACCOUNT_TAG/GATEWAY/openai
即可。支持丰富的自定义设置,
- 支持自定义系统名称,logo 以及页脚。
- 支持自定义首页和关于页面,可以选择使用 HTML & Markdown 代码进行自定义,或者使用一个单独的网页通过 iframe 嵌入。
支持通过系统访问令牌调用管理 API,进而在无需二开的情况下扩展和自定义 One API 的功能,详情请参考此处 API 文档。。
支持 Cloudflare Turnstile 用户校验。
支持用户管理,支持多种用户登录注册方式:
- 邮箱登录注册(支持注册邮箱白名单)以及通过邮箱进行密码重置。
- 支持飞书授权登录(这里有 One API 的实现细节阐述供参考)。
- 支持 GitHub 授权登录。
- 微信公众号授权(需要额外部署 WeChat Server)。
支持主题切换,设置环境变量
THEME
即可,默认为default
,欢迎 PR 更多主题,具体参考此处。配合 Message Pusher 可将报警信息推送到多种 App 上。
OneAPI的直接展示
你只需简单地修改Base URL,使用OneAPI的密钥,并写入模型名,就能立即开始使用了
比如,你可以通过Chatbox调用DeepSeek-Chat
而OneAPI会自动将请求分流到不同的渠道,使用起来非常灵活
如何部署OneAPI?
1. 直接运行部署
这是最简单的部署方式。只需下载OneAPI的二进制可执行文件,直接运行即可。程序会自动创建SQLite数据库和日志文件夹。建议你专门创建一个文件夹来保存这些文件,以确保程序运行顺畅。
二进制文件网盘链接:pan.baidu.com/s/17dWJKxackHuMqg7clhJrYg?pwd=n3hj
官方GitHub仓库releases:Releases · songquanpeng/one-api
2. Docker部署
如果你更喜欢使用Docker,直接复制项目主页上的相关运行命令即可。对于个人用户来说,SQLite数据库已经足够使用。关于Docker的安装和使用,网上有很多详细的教程,这里就不赘述了。
# 使用 SQLite 的部署命令:
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
# 使用 MySQL 的部署命令,在上面的基础上添加 `-e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi"`,请自行修改数据库连接参数,不清楚如何修改请参见下面环境变量一节。
# 例如:
docker run --name one-api -d --restart always -p 3000:3000 -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api
3. 宝塔面板/1Panel面板部署
面板部署适合那些喜欢通过图形界面管理服务的用户,面板的安装和部署就不再赘述了,网上已经有非常多的资料了。面板部署使用MySQL数据库,性能和安全性都会更好。安装时记得勾选“允许外部访问”选项,否则可能无法正常访问服务。
如何使用OneAPI?
登录后台
默认账号为root
,默认密码为123456
首次登录后请务必修改默认密码
创建API密钥
在后台管理界面中,点击创建API密钥,填入名称,并设置为无限额度且永不过期
添加渠道
选择你要集成的渠道类型,填入名称和该渠道的API Key
对于第三方渠道,操作方法基本一致,如果默认的模型中没有DeepSeek,你可以手动输入model id
模型重定向
这样一来,在model id中加上deepseek-chat
和deepseek-reasoner
,并完成模型重定向,你就能通过一个model id访问所有渠道的DeepSeek-Chat了
重定向json文本
{
"deepseek-chat": "deepseek-v3",
"deepseek-reasoner": "deepseek-r1"
}
解释
{
"重定向名字": "原名"
}
白嫖指南:如何免费使用DeepSeek API?
除了使用官方API,你还可以通过以下几种渠道免费使用DeepSeek的API:
1. 天翼云
model id在此处
这个App Key就是apikey
天翼云的API虽然不直接支持OneAPI,但它兼容OpenAI的API格式。你可以在OneAPI中选择自定义配置,将天翼云的Base URL和密钥填入,即可成功集成。
2. 硅基流动平台
使用手机号登录硅基流动平台,创建API密钥即可获取。通过UP主的邀请码JKSMEMLB
,你还可以获得额外赠送的余额,OneAPI直接支持硅基流动平台
重定向文本
{
"deepseek-chat": "deepseek-ai/DeepSeek-V3",
"deepseek-reasoner": "deepseek-ai/DeepSeek-R1"
}
3. 腾讯云
腾讯云也提供了OpenAI兼容的API功能,腾讯云较为简单,这里就不专门演示了,按照官网文档的操作如法炮制,你只需获取Base URL和API Key,按照相同的方式进行集成即可。
4. 火山引擎
火山引擎的使用方法较为不同。
进入火山方舟,点击在线推理
创建接入点
添加模型,选择DeepSeek
这个ep-xxxx就是model id
创建API Key
集成如OneAPI
最后
教程结束,建议配合b站视频食用deepseek第三方api太多?试试oneapi api聚合(部署教程+白嫖方法)_哔哩哔哩_bilibili