Cursor、Cherry Studio、LobeChat 如何配置 OpenAI 兼容 Base URL

很多用户并不是直接写代码调用接口，而是通过 Cursor、Cherry Studio、LobeChat、Chatbox 等客户端使用模型。对这类用户来说，最关键的是填对 Base URL、API Key 和模型名称，并能快速判断是密钥、余额、模型还是网络问题。

English summary: this guide explains how users of Cursor, Cherry Studio, LobeChat, and Chatbox can configure an OpenAI-compatible Base URL, API key, model name, streaming mode, and troubleshooting workflow.

It is designed for end users and small teams who need practical client configuration steps rather than backend integration details.

一、配置前先确认三件事

客户端配置通常只需要三个核心字段：Base URL、API Key 和模型名称。Base URL 决定请求发到哪里，API Key 决定权限和余额，模型名称决定实际调用的模型能力。

如果客户端支持自定义 OpenAI 兼容接口，一般不要把完整的 /chat/completions 路径填进去，而是填网关提供的基础地址，再让客户端自动拼接接口路径。

Base URL 是否以平台文档为准

API Key 是否属于当前账号或团队

模型名称是否和平台模型列表一致

客户端是否开启流式输出

二、常见故障排查顺序

先检查密钥是否复制完整，再检查余额和模型权限。如果提示模型不存在，通常是模型名称不匹配；如果一直转圈，优先检查网络、流式响应和客户端代理设置。

现象 | 可能原因 | 处理方式

401 或鉴权失败 | API Key 错误或过期 | 重新生成密钥并确认没有多余空格

模型不存在 | 模型名不匹配 | 复制平台模型列表里的完整名称

响应很慢 | 模型排队或网络波动 | 换低延迟模型或查看分组监控

三、团队使用建议

团队成员不要共用管理员密钥。更好的方式是给不同用途创建独立 Key，设置额度上限，并在出现异常消耗时能快速定位来源。

Base URL 需要带 /v1 吗？

以平台文档为准。有些客户端需要填写到 /v1，有些只需要填写域名和基础路径，配置后可用简单对话测试。

客户端配置后能用图片和视频模型吗？

取决于客户端是否支持对应接口。聊天客户端通常优先支持文本模型，图片和视频建议使用专门页面或 API 调用。