JBB 金贝贝 Logo JBB 金贝贝AI API Gateway · 原 JBBToken

CLIENT GUIDE / CHERRY STUDIO

Cherry Studio 接入 JBB：根地址、模型同步与逐项排错

Cherry Studio 官方支持自定义 OpenAI-compatible Provider。JBB 的 API 地址只填站点根地址 https://jbbt.pages.dev；再用专用 Key 同步当前可见模型，逐个确认 Chat Completions、能力和日志。

按步骤配置 直接看填写值

PRE-FLIGHT

准备官方 Cherry Studio、专用 JBB Key 和一个精确模型 ID

先从 Cherry Studio 官方渠道安装客户端，再在 JBB 控制台创建独立、低额度 Key。配置时只使用 API Key，不填写账号密码、Session、管理员 Token 或浏览器 Cookie。

02创建专用 Key

为 Cherry Studio 单独创建 JBB Key，限制额度并记录用途，方便日志追踪和快速禁用。

03确认模型 ID

从当前 Key 的 /v1/models 复制完整 ID，不使用显示名、营销名或其他 Key 的结果。

Cherry Studio 及相关商标归其权利人所有；本页不表示 JBB 与 Cherry Studio 存在官方合作、授权、预装或背书。

PROVIDER SETUP

从“设置 → 模型服务”添加自定义 Provider，八步完成

  1. 打开 Cherry Studio，进入设置 → 模型服务。
  2. 在 Provider 列表下方点击+ 添加或添加自定义服务商。
  3. 名称填写 JBB 金贝贝；旧版若要求类型，选择 OpenAI。
  4. API Key 填入 JBB 专用 Key；API 地址只填 https://jbbt.pages.dev。
  5. 点击管理 / 获取模型列表；对需要的模型逐个点击 +，或手工添加精确 ID。
  6. 若界面显示 endpoint type，标准对话模型选择 OpenAI Chat Completions。
  7. 点击 API Key 右侧检查，失败时先核对最后一个已添加的对话模型。
  8. 打开右上角启用开关，回到聊天页选择 JBB 模型发送一条短消息。

官方依据：自定义服务商、NewAPI 配置与模型服务设置。

FIELD MAP

API 地址只填根地址；不要粘贴 /v1/chat/completions

Cherry Studio 字段JBB 填写值边界
Provider 名称JBB 金贝贝仅用于客户端内识别。
Provider 类型OpenAI / 自定义 Provider当前自定义流程默认主端点为 Chat Completions。
API Key<YOUR_JBB_API_KEY>只填专用 Key，不填账号密码。
API 地址 / Base URLhttps://jbbt.pages.dev不带 /v1，不带 endpoint，末尾无需 #。
模型 ID<EXACT_MODEL_ID>来自当前 Key 的 GET /v1/models。
Endpoint typeOpenAI Chat CompletionsResponses / Anthropic / Gemini 需单独实测。
启用开关ON关闭时模型不会出现在选择列表。
参数摘要
Provider: JBB 金贝贝
Protocol: OpenAI Chat Completions
Base URL: https://jbbt.pages.dev
API Key: <YOUR_JBB_API_KEY>
Model: <EXACT_MODEL_ID_FROM_/v1/models>
JBB 不需要“完整地址 + #”模式

Cherry Studio 官方只建议在非标准路由时用完整 API 地址并以 # 结尾。JBB 使用标准 /v1/chat/completions，因此填写根地址即可。

MULTI-MODEL

一个 Provider 可以放多个模型，但要逐个添加、逐个验证

“获取模型列表”不等于全部启用。Cherry Studio 官方说明：必须点击模型右侧的 +，模型才会进入可用列表。模型 ID、端点类型和能力都应按当前 Key 的真实返回与实测配置。

  • 批量发现：点击管理或获取模型列表，再只添加实际会使用的模型。
  • 手工添加：若自动列表不可用，从 /v1/models 复制完整 ID，不改大小写或前缀。
  • 检查顺序：官方文档说明连接检查默认使用列表中的最后一个对话模型；先保证它可用。
  • 模型隔离：文本、vision、tool use、embedding 与 image generation 不要仅凭名称混用。
  • 多 Key 轮询：多个 Key 用英文逗号分隔；只有模型权限、分组与额度策略一致时才放在一起。
交替成功 / 失败通常不是随机

如果多 Key 的模型权限不同，Cherry Studio 轮询到不同 Key 时就可能交替成功和失败。先改为单 Key 验证，再统一权限后恢复轮询。

CONNECTION TEST

先用 /v1/models 预检，再执行客户端 Check 和首条短对话

GET /v1/models 是只读预检；首条 Chat Completions 可能产生少量计费。使用低额度专用 Key，不做无上限重试。

Bash / Zsh · 只读模型预检
export JBB_API_KEY="<YOUR_JBB_API_KEY>"
curl -sS "https://jbbt.pages.dev/v1/models" \
  -H "Authorization: Bearer $JBB_API_KEY"
Windows PowerShell · 只读模型预检
$env:JBB_API_KEY = "<YOUR_JBB_API_KEY>"
$Headers = @{ Authorization = "Bearer $env:JBB_API_KEY" }
Invoke-RestMethod -Uri "https://jbbt.pages.dev/v1/models" -Headers $Headers
检查通过信号下一步
GET /v1/models200 且看到目标 ID复制精确 ID 到 Cherry Studio。
Provider Check最后一个对话模型通过再逐个检查其他模型。
首条短对话回复与 usage 正常核对 JBB 日志和扣费。
JBB 日志时间、Key、模型、状态一致无日志则先查本机网络和 Base URL。

ENDPOINT & CAPABILITY

标准对话先用 Chat Completions；其他协议只按模型实测启用

当前 Cherry Studio 自定义 Provider 的主端点默认是 openai-chat-completions。New API Provider 还支持按模型切换 Responses、Anthropic Messages 和 Gemini，但模型名本身不能证明协议。

01Chat Completions

JBB 标准文本对话的默认选择，路径由 Cherry Studio 自动拼接。

02能力逐项开

vision、reasoning、tool use 只有在当前模型 × Key × 分组链路实测后启用。

03其他端点隔离

Responses、Anthropic、Gemini、embedding 和图片模型分别测试，不用一次成功外推全部能力。

代码事实来源：Cherry Studio 官方仓库当前 Provider 与 endpoint 配置。

TROUBLESHOOTING

先看“最后一个模型”和 Base URL，再查 Key、端点与上游

  • 401
    Key 未被接受

    检查专用 Key 是否正确、启用且未过期；多 Key 时先只保留一个。

  • 404
    模型或路径不存在

    API 地址只填根地址；重新从当前 Key 的 /v1/models 复制完整模型 ID。

  • 400
    端点或能力不兼容

    将 endpoint type 改回 Chat Completions，关闭未验证能力，用纯文本最小请求重试一次。

  • CHECK
    检查失败但部分模型可用

    Cherry Studio 默认检查最后一个对话模型；删除或修正它后，再逐个模型验证。

  • 429
    额度、并发或频率限制

    检查 JBB 余额、Key 限额和渠道状态；采用有上限退避，禁止快速无限重试。

  • 5xx
    JBB、渠道或上游异常

    保存发生时间、模型、Key 标识、请求 ID 和错误正文，再对照任务日志。

  • NO LOG
    客户端报错但 JBB 无日志

    请求未到达 JBB；检查 Base URL、DNS、系统代理、TLS、本机网络和当前 Provider。

KEY & PRIVACY

Key 只留在自己的客户端；多模型不等于多权限

  • 为 Cherry Studio 使用独立、低额度 Key，不复用管理员或生产主 Key。
  • 不在截图、导出文件、聊天、工单、deep link 或 Git 中携带真实 API Key。
  • 多个 Key 轮询前先确认分组、模型权限和额度策略一致；否则保持单 Key。
  • 发送给模型的对话、上下文和附件会进入 JBB 及选定上游；先脱敏再发送。
  • 发现异常调用时先禁用 Cherry Studio 专用 Key，不影响其他客户端。

FAQ

Cherry Studio 接入 JBB 常见问题

  • Q1
    API 地址要不要带 /v1？

    不要。填写 https://jbbt.pages.dev，Cherry Studio 自动拼接标准路径。

  • Q2
    为什么管理页看到模型，聊天页却没有？

    获取列表后还要点击模型右侧 +，并打开 Provider 右上角启用开关。

  • Q3
    为什么 Check 只在某些模型失败？

    检查默认使用最后一个对话模型。先核对它的 ID 和 endpoint type，再逐个模型测试。

  • Q4
    一个 Provider 能放多个模型吗？

    可以。只添加当前 Key 可见且会实际使用的模型，并分别验证能力。

  • Q5
    可以填多个 JBB Key 吗？

    可以用英文逗号分隔并轮询，但必须先保证模型权限、分组和额度策略一致。

  • Q6
    JBB 没日志却一直报错怎么办？

    优先检查本机网络、系统代理、TLS、Base URL 和当前选择的 Provider。

创建专用 Key 查看模型 查看协议边界 对照 Chatbox 配置 运行 Quick Start