ROIBest AI 文档

Cherry Studio

在 Cherry Studio 里添加一个 OpenAI 兼容的自定义服务商。

This content is not available in your language yet.

Cherry Studio 支持添加自定义服务商。界面位置随版本变化，这里给通用步骤。

前置条件

一把 OpenAI 协议的 API Key。
已知道要用的模型名。

步骤

打开设置中的模型服务（或「服务商」）页面。
新增一个服务商，类型选择 OpenAI 或 OpenAI 兼容。
API 地址 填 https://ai.roibest.com/v1。
API 密钥 填你的 sk- 密钥。
在该服务商下添加模型，模型 ID 填 /v1/models 返回的名字。
保存，然后在会话里把当前模型切到刚添加的这一个。

如果输入框只接受域名而不接受路径，填 https://ai.roibest.com，客户端会自行补 /v1。填完先用界面上的连通性检查确认一次。

Cherry Studio 服务商字段示意：名称 ROIBest AI、OpenAI 类型、带 v1 的 API 地址、密钥和模型 ID — 服务商配置示意图，非软件截图。保存并启用后，在会话中选择新模型；点击图片查看大图。

验证

curl https://ai.roibest.com/v1/chat/completions \
  -H "Authorization: Bearer $ROIBEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model","messages":[{"role":"user","content":"hello"}]}'

curl 通、界面不通时，问题在客户端配置而不在密钥。

常见问题

连通性检查报 404。 地址拼成了 https://ai.roibest.com/v1/v1。客户端会自动补 /v1 时不要自己再写一遍。

模型列表拉不出来。 手动添加模型 ID，不依赖自动拉取。

要同时用 Claude 模型。 在同一个服务商下添加对应模型即可，网关按模型名路由，不需要再建一个 Anthropic 服务商。