摘要

Chatbox、Cherry Studio、Open WebUI 等 AI 客户端通常都支持自定义 OpenAI 兼容 API。只要服务支持 OpenAI 格式，就可以通过填写 Base URL、API Key 和模型名接入。

本文用 51relay 作为示例，整理一份客户端配置 OpenAI 兼容 API 的通用教程，适合搜索“Chatbox 怎么配置 API”“Cherry Studio 怎么配置 OpenAI API”“Open WebUI 怎么配置 API 地址”的用户参考。

一、OpenAI 兼容 API 是什么

OpenAI 兼容 API 指的是接口路径、请求格式和认证方式与 OpenAI API 类似。

常见字段：

Base URL API Key Model

常见请求路径：

/models /chat/completions

以 51relay 为例，OpenAI 兼容 Base URL 通常是：

https://你的51relay域名/v1

API Key 示例：

sk-xxxxxxxxxxxxxxxx

二、配置前先测试接口

建议先用 curl 测试，不要直接在客户端里盲填。

export RELAY_BASE_URL="https://你的51relay域名/v1" export RELAY_API_KEY="sk-xxxxxxxxxxxxxxxx"

查询模型：

curl -sS "$RELAY_BASE_URL/models" \ -H "Authorization: Bearer $RELAY_API_KEY"

最小对话：

curl -sS "$RELAY_BASE_URL/chat/completions" \ -H "Authorization: Bearer $RELAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "你的模型名", "messages": [ { "role": "user", "content": "你好，请回复一句：接口已接通" } ] }'

如果 curl 能返回内容，再去配置客户端。

三、Chatbox 配置 OpenAI 兼容 API

Chatbox 一般支持自定义 OpenAI API 地址。

填写示例：

API 类型：OpenAI / OpenAI Compatible API Key：sk-xxxxxxxxxxxxxxxx Base URL：https://你的51relay域名/v1 Model：你的模型名

注意事项：

1. API Key 一般只填 sk-xxx，不要加 Bearer。
2. Base URL 一般填到 /v1。
3. 模型名需要和服务端返回一致。
4. 如果模型列表没有自动出现，可以手动添加模型名。

测试消息：

你好，请回复一句：Chatbox 已接通

四、Cherry Studio 配置 OpenAI 兼容 API

Cherry Studio 也可以添加自定义服务。

填写示例：

服务类型：OpenAI Compatible API 地址：https://你的51relay域名/v1 API Key：sk-xxxxxxxxxxxxxxxx 模型名：你的模型名

建议流程：

1. 新增自定义服务。
2. 填写 API 地址和 Key。
3. 添加模型名。
4. 保存。
5. 用一句短 prompt 测试。

常见问题：

1. 401：Key 错。
2. 404：Base URL 错。
3. model not found：模型名错。
4. timeout：网络或上游响应慢。

五、Open WebUI 配置 OpenAI 兼容 API

Open WebUI 常用于本地部署或团队内部使用。

常见配置：

OpenAI API Base URL：https://你的51relay域名/v1 OpenAI API Key：sk-xxxxxxxxxxxxxxxx Model：你的模型名

如果是 Docker 部署，需要注意：

1. Open WebUI 所在容器是否能访问外部 API。
2. 环境变量是否正确传入容器。
3. 后台配置是否覆盖了环境变量。
4. 模型列表是否刷新。

如果本机能 curl 通，但 Open WebUI 里不通，建议进入服务器或容器里再 curl 一次。

六、通用配置对照表

客户端	API 类型	Base URL	API Key	模型
Chatbox	OpenAI Compatible	https://你的51relay域名/v1	sk-xxx	服务端模型名
Cherry Studio	OpenAI Compatible	https://你的51relay域名/v1	sk-xxx	服务端模型名
Open WebUI	OpenAI Compatible	https://你的51relay域名/v1	sk-xxx	服务端模型名

七、常见错误排查

1. 401

优先检查：

1. API Key 是否复制完整
2. 是否多了空格
3. 是否错误添加了 Bearer
4. Key 是否过期或被删除

2. 404

优先检查：

1. Base URL 是否填到 /v1
2. 是否误填了完整路径 /chat/completions
3. 客户端是否自动拼接路径

正确示例：

https://你的51relay域名/v1

错误示例：

https://你的51relay域名/v1/chat/completions

3. model not found

先查模型：

curl -sS "$RELAY_BASE_URL/models" \ -H "Authorization: Bearer $RELAY_API_KEY"

然后把返回里的模型名复制到客户端。

4. timeout

排查：

1. 先用短 prompt。
2. 检查本机或服务器网络。
3. 检查是否通过代理。
4. 检查服务端状态。

八、推荐配置流程

1. 获取 Base URL 和 API Key 2. curl 查询模型列表 3. curl 跑最小对话 4. 打开客户端 5. 填写 Base URL、API Key、模型名 6. 发送短 prompt 7. 再测试真实任务

不要跳过第 2 和第 3 步。

九、总结

Chatbox、Cherry Studio、Open WebUI 配置 OpenAI 兼容 API，本质都是填三件事：

Base URL API Key Model

如果出错，就按：

401 查 Key 404 查 Base URL model not found 查模型名 timeout 查网络和请求长度

本文用 51relay 作为 GPT / Claude API 中转示例。51relay 只做 GPT / Claude 中转，支持 OpenAI 兼容和 Claude 兼容接入，适合 AI 客户端配置、开发测试和自动化工作流。