通过开桥使用 Cherry Studio 指南
Cherry Studio 是一款优雅的跨平台 AI 桌面客户端,支持多种主流大语言模型服务。通过与开桥的集成,你可以在 Cherry Studio 中访问开桥平台上聚合的海量模型资源,享受更灵活的模型选择和更优惠的价格。
兼容性说明
开桥完全支持 OpenAI Chat Completions 协议,可以平滑集成到 Cherry Studio 等支持自定义 OpenAI 兼容端点的客户端中。只需添加开桥作为模型提供商,即可使用所有支持 OpenAI 协议的模型。
注意 OpenAI 协议的 base_url 为 https://openqiao.com/api/v1/。
配置方案
步骤 1：下载并安装 Cherry Studio
前往 Cherry Studio 官网 下载适合你操作系统的版本并完成安装。
步骤 2：添加开桥模型提供商
打开 Cherry Studio,进入 Settings → Model Provider 界面
点击 Add 按钮添加新的模型提供商
在弹出的配置窗口中填写以下信息:
- Provider Name:
开桥(或你偏好的名称) - Provider Type: 选择
OpenAI - API Key: 填入你的开桥 API Key (格式为
sk-ai-v1-xxx) - API Host:
https://openqiao.com/api/v1/
- Provider Name:
重要配置
确认将 sk-ai-v1-xxx 替换为你的真实开桥 API Key。你可以在 开桥控制台 中获取 API Key。
配置说明
- Provider Name: 自定义名称,建议使用
开桥便于识别 - Provider Type: 必须选择
OpenAI,因为开桥支持 OpenAI Chat Completions 协议 - API Key: 你的开桥 API Key,用于身份认证和计费
- API Host: 开桥 OpenAI 兼容端点地址,必须以
/结尾
步骤 3：拉取可用模型列表
配置完成后,点击 Manager 按钮,Cherry Studio 会自动从开桥拉取所有支持 OpenAI Chat Completions 协议的模型列表。
模型发现
Cherry Studio 会通过开桥的 /v1/models API 端点自动发现所有可用模型,无需手动添加。
步骤 4：添加需要使用的模型
从拉取到的模型列表中,选择你需要使用的模型并添加到你的模型库中。
模型推荐
建议添加不同能力和价格层级的模型,以适应不同使用场景:
- 高性能模型:
openai/gpt-5、anthropic/claude-sonnet-4.5 - 均衡模型:
google/gemini-2.5-pro、x-ai/grok-4-fast - 高性价比模型:
deepseek/deepseek-chat、qwen/qwen3-coder-plus
步骤 5：开始对话
前往聊天界面,选择开桥提供商下的任意模型,即可开始使用。
模型切换
你可以在对话过程中随时切换不同的模型,Cherry Studio 会保留对话历史,方便你比较不同模型的表现。
支持的模型
OpenAI 协议支持模型说明
开桥平台上支持 OpenAI Chat Completions 协议的模型数量众多且持续增加。你可以通过以下方式查看完整的支持列表:
- 访问 开桥模型列表 并筛选 "OpenAI API Compatible"
- 或访问具体模型的详情页面,查看其协议支持情况
查看更多模型
访问 开桥模型列表 了解所有可用模型及其详细信息,包括定价、上下文长度、功能特性等。
使用效果
配置完成后,你可以在 Cherry Studio 中平滑使用开桥的多种模型:
- 统一的对话界面,无需在不同客户端间切换
- 实时切换模型,比较不同模型的回答质量
- 完整的对话历史管理和导出功能
- 支持文件上传、多模态输入等高级功能
功能支持
不同模型支持的功能可能有所差异,例如视觉理解、函数调用等。请参考具体模型的详情页面了解其支持的功能特性。
故障排除
常见问题解决
API Key 错误
问题: 添加提供商时提示 API Key 无效或未授权
解决方案:
- 检查 API Key 是否正确复制,注意不要包含多余的空格或换行
- 确认 API Key 格式是否以
sk-ai-v1-开头 - 验证 API Key 是否已激活且账户有足够余额
- 登录 开桥控制台 确认 API Key 状态
无法拉取模型列表
问题: 点击 Manager 按钮后无法获取模型列表
解决方案:
- 检查 API Host 配置是否正确为
https://openqiao.com/api/v1/(注意结尾的斜杠) - 验证网络连接是否正常,尝试在浏览器访问
https://openqiao.com - 确认防火墙或代理设置未阻止对开桥服务器的访问
- 检查 Cherry Studio 版本是否为最新,旧版本可能存在兼容性问题
模型调用失败
问题: 选择模型发送消息后返回错误
解决方案:
- 确认所选模型仍在开桥平台上可用(部分模型可能下线)
- 检查账户余额是否充足
- 验证模型是否支持你的请求参数(如 temperature、max_tokens 等)
- 查看错误信息中的具体提示,根据提示调整请求参数
- 尝试切换到其他模型测试,排查是否为特定模型的问题
响应速度慢
问题: 模型响应时间过长或卡顿
解决方案:
- 检查网络连接质量,使用网络测速工具诊断
- 尝试切换到标注为 "fast" 的模型(如
x-ai/grok-4-fast) - 减少单次请求的 token 数量,降低
max_tokens参数 - 避免在高峰时段使用,或选择负载较低的模型
- 如持续出现问题,联系开桥技术支持获取帮助