English
Integration docs

BitCloud API Documentation

Browse Base URL, API key, model, and client setup guides for connecting tools to the unified gateway.

Current documentCherry Studio
Markdown rendered as page contentCherry Studio

Cherry Studio 配置

BitCloud API 兼容 OpenAI 协议,支持 Cherry Studio 桌面客户端,可参考本文进行配置与使用。


前置工作

获取凭证

项目
BASE_URL(OpenAI 兼容协议)https://web.bitcloud.com.cn/v1
API Key格式:sk-xxxxx
获取方式前往 控制台 → 令牌管理 页面创建

安装 Cherry Studio

Cherry Studio 是一款桌面 AI 客户端,支持多模型对话。


配置基本信息

1. 添加自定义供应商

点击右上角设置图标,进入模型服务页面,添加自定义 OpenAI 兼容供应商。

2. 填写配置信息

字段
供应商名称BitCloud(或自定义名称)
API Hosthttps://web.bitcloud.com.cn/v1
API Key从控制台获取的密钥

3. 添加模型

在供应商下添加可用模型,例如:

  • gpt-4o
  • claude-sonnet-4-20250514
  • deepseek-chat

具体可用模型请在 模型广场 查看。


使用 Cherry Studio

在模型列表中选择需要使用的模型,即可正常对话。

开启思考模式(可选)

点击助手设置,添加自定义参数:

json"thinking": {"type": "enabled"}

也可根据需求,设置温度、上下文等其他参数。


常见问题

API Host 应该填什么?

填入 BitCloud 的 Base URL:https://web.bitcloud.com.cn/v1,注意以 /v1 结尾。

模型列表为空?

请确认已正确填写 API Host 和 API Key,并手动添加了模型 ID。