One-API 怎么用：一站式多模型管理指南

One-API 是一个强大的工具，它通过标准的 OpenAI API 格式，帮助用户轻松访问多个大模型，如 OpenAI ChatGPT、Google PaLM2、百度文心和讯飞星火等。本文将详细介绍 One-API 的安装、配置、使用以及常见问题解答，帮助你全面了解 One-API 的应用。

什么是 One-API

One-API 提供了一个统一的接口，让用户可以通过一个标准的 OpenAI API 格式访问不同的大模型。这种统一性简化了不同模型的调用过程，使得多模型管理变得更加高效和便捷。One-API 支持多种大模型，包括但不限于 OpenAI、Google、百度、阿里和讯飞等，极大地拓展了用户的选择范围。

One-API 支持的模型

本地安装 One-API

安装准备

在安装 One-API 之前，你需要确保本地环境满足以下条件：

安装 Docker 或有能力进行手动部署。
下载 One-API 的安装包或源码。

如果你选择 Docker 安装，可通过以下命令拉取 One-API 镜像：

docker pull justsong/one-api

手动安装步骤

如果你更倾向于手动安装，可以下载 One-API 的可执行文件并运行。以下是手动安装的步骤：

下载适合你操作系统的可执行文件。
双击运行该文件。
打开浏览器访问 http://localhost:3000/，即可进入 One-API 的配置界面。

One-API 配置界面

配置 One-API

用户登录

首次访问 One-API 配置界面时，你需要登录。默认的账号是 root，密码是 123456。建议首次登录后立即修改密码以确保安全。

渠道配置

One-API 的灵活性体现在其渠道配置功能上。通过设置不同的渠道，你可以管理和调用不同的大模型。

登录后，在渠道管理页面点击“添加新的渠道”。
选择所需的大模型类型。
根据提示输入相应的 API 密钥，例如 APPID|APISecret|APIKey。
保存设置。

配置渠道

使用 One-API

API 调用测试

一旦配置完成，你可以使用 API 调用来测试 One-API 的功能。以下是一个简单的调用示例：

POST http://localhost:3000/v1/chat/completions

Headers: Authorization: Bearer {OneApiToken}

Body: {

  "model": "SparkDesk-v3.5",

  "messages": [

    {

      "role": "user",

      "content": "给我讲个笑话吧。"

    }

  ]

}

通过 API 调用，你可以轻松测试不同的模型。注意在请求头中包含正确的令牌格式 Bearer {OneApiToken}。

接口测试效果

Python 代码调用

One-API 兼容 OpenAI 的代码调用方式，只需设置环境变量即可使用。以下是 Python 的调用示例：

import openai



openai.api_base = "http://localhost:3000/v1"

openai.api_key = "your-api-key"



response = openai.Completion.create(

  model="SparkDesk-v3.5",

  messages=[

    {"role": "user", "content": "讲个笑话吧。"}

  ]

)

print(response)

常见问题解答（FAQ）

FAQ

问：如何配置多个大模型？
- 答：在 One-API 中，你可以通过添加不同的渠道来配置多个大模型。在每个渠道中设置相应的模型类型和 API 密钥即可。
问：如何确保 API 调用的安全性？
- 答：建议在首次登录 One-API 后立即修改默认密码。此外，确保 API 调用时使用 HTTPS 协议，避免信息泄露。
问：One-API 支持哪些大模型？
- 答：One-API 支持 OpenAI、Google、百度、阿里和讯飞等多个大模型，具体支持的模型类型可以在配置界面查看。
问：如何处理 One-API 的调用错误？
- 答：检查调用参数是否正确，特别是 API 密钥和模型名称。如果问题仍然存在，可以查看 One-API 的日志以获取更多信息。
问：One-API 是否支持自定义模型名称？
- 答：是的，One-API 允许用户自定义模型名称，但需确保在模型列表中包含这些名称。