零基础教程：用One API统一访问所有AI大模型-育师

零基础教程：用One API统一访问所有AI大模型

1. 为什么需要统一的AI模型访问入口

现在AI大模型太多了，每个厂商都有自己的API接口和调用方式。想用OpenAI的GPT-4写文章，又想用百度的文心一言做翻译，还想用阿里的通义千问分析数据，每个都要单独注册账号、学习不同的调用方法，实在太麻烦了。

One API就是为了解决这个问题而生的。它就像一个"万能转换器"，让你用一套标准的OpenAI API格式，就能访问市面上几乎所有主流的大模型。不管你用的是什么模型，调用方式都一样简单。

想象一下，你只需要学习一种API调用方法，就能同时使用几十种不同的AI模型，还能轻松管理你的API密钥，甚至在不同模型之间做负载均衡。这就是One API带来的便利。

2. 快速部署One API

2.1 环境准备

在开始之前，你需要准备：

一台Linux服务器（云服务器或本地机器都可以）
安装好Docker环境
3000端口没有被占用

如果你还没有安装Docker，可以用下面这个命令快速安装：

# 安装Docker curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh # 启动Docker服务 sudo systemctl start docker sudo systemctl enable docker

2.2 一键部署One API

最简单的部署方式是使用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

这个命令做了以下几件事：

创建名为one-api的容器并在后台运行
设置自动重启，确保服务稳定
将容器的3000端口映射到主机的3000端口
设置时区为上海时间
将数据持久化到主机的/home/ubuntu/data/one-api目录

如果你想使用MySQL数据库（推荐用于生产环境），可以使用这个命令：

# 使用MySQL数据库部署 docker run --name one-api -d --restart always \ -p 3000:3000 \ -e SQL_DSN="root:你的密码@tcp(数据库地址:3306)/oneapi" \ -e TZ=Asia/Shanghai \ -v /home/ubuntu/data/one-api:/data \ justsong/one-api

记得把命令中的"你的密码"和"数据库地址"替换成实际的MySQL信息。

3. 初始配置和登录

部署完成后，打开浏览器访问http://你的服务器IP:3000，你会看到One API的登录界面。

使用默认账号登录：

用户名：root
密码：123456

重要安全提示：登录后第一件事就是修改默认密码！在系统设置中找到修改密码的选项，设置一个强密码。

4. 添加和管理AI模型渠道

4.1 添加第一个模型渠道

登录成功后，点击左侧菜单的"渠道"，然后点击"添加新的渠道"。这里以添加OpenAI渠道为例：

类型选择：选择"OpenAI"
名称：起个容易识别的名字，比如"我的OpenAI账户"
密钥：填入你在OpenAI官网获取的API密钥（格式为sk-开头的字符串）
分组：保持默认的"default"即可
模型：系统会自动获取该渠道支持的模型列表
自动禁用：建议开启，当渠道出现故障时自动禁用

点击"提交"后，可以点击"测试"按钮验证渠道是否配置正确。

4.2 支持的主流模型

One API支持几乎所有主流的大模型，包括：

OpenAI系列：GPT-4、GPT-3.5、GPT-4 Turbo等
百度文心一言：ERNIE-Bot、ERNIE-Bot-turbo等
阿里通义千问：Qwen-Max、Qwen-Turbo等
讯飞星火：SparkDesk系列
智谱AI：ChatGLM系列
Google：Gemini Pro、PaLM 2等
Anthropic：Claude系列
还有360智脑、腾讯混元、字节豆包等几十种模型

每个模型的添加方式都类似，只需要提供对应的API密钥即可。

4.3 渠道分组和负载均衡

One API的强大之处在于可以设置多个相同模型的渠道，并自动进行负载均衡：

添加多个渠道：为同一个模型添加多个API密钥
自动轮询：系统会自动在这些渠道间轮询，提高可用性
故障转移：当某个渠道失败时，自动切换到其他可用渠道

5. 创建和管理访问令牌

5.1 生成访问令牌

在"令牌"页面，点击"新增令牌"：

名称：给令牌起个描述性的名字，如"我的应用令牌"
权限：选择"用户"或"管理员"（一般应用选择"用户"即可）
额度：设置这个令牌的最大使用额度
过期时间：设置令牌的有效期

点击"提交"后，系统会生成一个以"sk-"开头的令牌字符串，这个就是你的API访问密钥。

5.2 令牌管理技巧

按应用分配：为每个应用创建独立的令牌，方便监控和管理
设置额度限制：防止某个应用过度消耗资源
定期轮换：定期更新令牌增强安全性

6. 如何使用One API接口

6.1 基础API调用

使用One API的方式与直接使用OpenAI API完全一样，只需要修改API地址：

import openai # 设置API密钥和基础地址 openai.api_key = "你的OneAPI令牌" openai.api_base = "http://你的服务器IP:3000/v1" # 调用聊天接口 response = openai.ChatCompletion.create( model="gpt-3.5-turbo", messages=[ {"role": "user", "content": "你好，请介绍一下你自己"} ] ) print(response.choices[0].message.content)

6.2 指定使用特定模型

如果你想指定使用某个特定的模型，可以在令牌后面添加渠道ID：

# 使用特定渠道的令牌格式：原始令牌-渠道ID special_token = "sk-your-token-here-channel-id" # 这样就会强制使用指定的渠道

6.3 流式响应

One API支持流式响应，可以实现打字机效果：

response = openai.ChatCompletion.create( model="gpt-3.5-turbo", messages=[{"role": "user", "content": "写一个短故事"}], stream=True ) for chunk in response: content = chunk.choices[0].delta.get("content", "") if content: print(content, end="", flush=True)

7. 高级功能和使用技巧

7.1 模型映射和重定向

One API支持模型映射功能，可以将请求的模型重定向到其他模型：

兼容性处理：让只支持OpenAI格式的应用也能使用其他模型
成本优化：将请求自动路由到更经济的模型
性能优化：根据模型性能智能路由

7.2 使用Redis提升性能

对于高并发场景，建议配置Redis缓存：

# 启动时添加Redis环境变量 docker run ... -e REDIS_CONN_STRING="redis://:密码@redis服务器:6379" ...

7.3 多机部署

对于大规模应用，可以部署多个One API实例：

主从架构：一个主节点多个从节点
共享数据库：所有节点连接同一个MySQL数据库
负载均衡：在前端用Nginx做负载均衡

8. 常见问题解答

8.1 渠道测试失败怎么办？

如果渠道测试报错，检查以下几点：

API密钥是否正确
网络连接是否正常
模型服务商账户是否有余额

8.2 如何查看使用统计？

在"日志"页面可以查看详细的使用记录，包括：

每个请求的token消耗
模型使用情况
用户使用统计

8.3 如何设置用户权限？

One API支持多用户系统，可以：

创建子账户并分配不同权限
设置每个用户的额度限制
管理用户分组和渠道分组

9. 总结

One API是一个极其强大的AI模型统一管理平台，让你用一套接口就能访问几乎所有主流大模型。通过本教程，你应该已经掌握了：

快速部署：用Docker一键部署One API服务
渠道管理：添加和管理各种AI模型的API渠道
令牌管理：创建和管理访问令牌
API使用：用标准OpenAI格式调用各种模型
高级功能：负载均衡、模型映射等高级用法

无论你是个人开发者想要更方便地使用多个AI模型，还是企业需要统一管理AI资源，One API都是一个绝佳的选择。现在就去试试吧，体验一把"一个接口，所有模型"的便利！

获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。

零基础教程：用One API统一访问所有AI大模型