模型与 API

Cherry Studio 怎么接入小蓝助手:API 地址、模型添加与连接检查

在 Cherry Studio 使用小蓝助手AI的模型接口,需要配好服务商地址、API Key 和具体模型,再启用服务商。本指南按官方文档说明桌面端的配置顺序,重点解释地址拼接、同步后添加模型和检查失败时该看哪里。

更新:2026-11-13

先准备 Key 和一个可用的文本模型

先在小蓝官网模型广场查看型号、接口方式和当前价格,再登录控制台创建或检查 API Key。确认 Key 所属分组、额度及可调用范围,复制一个明确支持 OpenAI Chat Completions 的文本模型 ID。

本篇先配置文本聊天。小蓝平台还提供其他类型的模型能力,但图像、视频、音频或其他协议需要各自的接口与参数;不能因为 Cherry Studio 显示了相应入口,就把同一个聊天地址用于所有功能。

API Key 填入自己的客户端,不放进截图、共享配置或公开求助信息。使用别家的 Key、账号余额或订阅,不会自动获得小蓝接口的调用权限。

添加自定义服务商,名称填“小蓝助手AI”

打开 Cherry Studio 的设置,进入“模型服务”(官方英文界面为 Model Provider),点击服务商列表下方的“添加服务商”。服务商名称填写“小蓝助手AI”,便于以后区分 Key、模型和费用来源。

当前官方文档中的添加窗口支持按协议分别填写端点。接入本文的文本聊天时,填写 OpenAI 对应的地址和小蓝 API Key;Anthropic、OpenAI Responses、Gemini、图像生成或编辑等字段,只有在确认所选服务支持时才配置。它们不是必须全部填写的项目。

保存后回到新建的服务商页面,继续核对地址并添加模型。不同版本的字段和按钮名称可能有变化,地址下方的最终请求预览与该版本官方说明应一起检查。

API 地址怎么填:以最终请求路径为准

小蓝官网提供的兼容 Base URL 是 https://api.bluedoai.com/v1。文本聊天请求在其后加上 /chat/completions,可按下面的规则核对地址。

Cherry Studio 官方“API Host”规则会自动补上 /v1/chat/completions。在使用这套规则的输入框中,填写 https://api.bluedoai.com,然后核对预览是否正好是上述聊天请求地址。不要把官网首页、登录页或模型广场当接口地址。

如果版本提供分协议的 OpenAI 端点输入框,先按该字段说明填写,再查看最终路径预览;不能把通用 SDK 的 Base URL 与会自动补路径的 API Host 当成完全相同的字段。

  • 普通 API Host:https://api.bluedoai.com,按官方规则补成 /v1/chat/completions。
  • 按官方 API Host 的末尾斜杠规则,也可填写 https://api.bluedoai.com/v1/;客户端仅追加 chat/completions。不要再另加一次 /v1。
  • 需要明确指定完整聊天地址时,官方 API Host 规则支持 https://api.bluedoai.com/v1/chat/completions#,末尾 # 表示不再补路径。此标记是客户端输入规则,不是小蓝要求添加到实际请求路径的参数。
  • 以上写法择一使用,并以该字段的请求预览为准。若最终出现 /v1/v1、两次 chat/completions 或跳到网页,先修正地址。

同步模型后,还要添加并启用

点击模型区域的“同步模型”(Sync models),获取该 Key 可见的目录,再把准备使用的文本模型加入服务商模型列表。同步到目录不等于已经加入聊天选择列表。

也可以点击同步按钮旁的“+”手动添加,填写完整模型 ID、显示名称和分组名称。模型 ID 必须与小蓝当前可用目录一致;显示名称可以方便自己识别。Cherry Studio 的列表分组名称用于整理显示,不会改变小蓝 API Key 的后台分组或权限。

打开服务商页面右上角的启用开关,再回到聊天界面,选择这个服务商下刚添加的模型。仍然看不到模型时,先检查“已添加到列表”和“已启用”这两项。

模型检查失败,先确认实际检查的是哪一个

官方说明中,“模型检查”(Model Check)默认使用模型列表中最后添加的聊天模型。这个模型如果不受支持、ID填错或没有权限,检查就可能失败;不能仅凭一个失败提示断定整个平台或 Key 都不可用。

先保留错误原文,确认被检查的模型和最终请求地址。需要发送消息核对时,用新对话、纯文本和一个已确认有权限的模型缩小范围。模型检查和正式发送都可能产生用量,按当前服务规则查看记录。

  • 模型不显示:检查是否只同步了目录而没有添加,以及服务商开关是否开启。
  • 认证或权限错误:核对当前服务商使用的 Key、Key 状态、所属分组和模型权限;不要直接在多个服务商之间反复换填密钥。
  • 404或返回网页:核对 OpenAI 端点、地址补全方式和最终路径;若错误明确写模型不存在,再核对完整模型 ID。
  • 网络超时:核对设备网络和 Cherry Studio 的代理设置;网页能打开不代表模型请求一定可达。
  • 额度、参数或上下文错误:按错误原文分别检查账户额度、所选型号的参数限制,以及历史消息和附件,不用连续重试代替排查。

优惠和实际费用,到小蓝平台核对

小蓝助手AI提供官方满血模型与按型号的算力优惠。配置前查看实时模型广场,核对同一型号、同一分组的输入价、输出价及适用的缓存或长度分档,不把某个型号的优惠当成全部模型的统一折扣。

调用后到小蓝控制台查看用量与账单,核对模型、时间、Token和费用。Cherry Studio 的显示名称、回答中的自报型号或客户端估算,不能代替服务端记录。

聊天历史、长输出和附件可能增加实际输入输出用量。需要限制预算时,结合 Key 的额度设置和型号参数管理;价格、计费单位和可用状态以实时模型广场及账户适用条件为准。

需要协助时,保留这些信息

记录 Cherry Studio 版本、操作系统、配置的协议和公开请求地址、完整模型 ID、发生时间与时区、错误原文,以及问题发生在同步模型、模型检查还是聊天发送。附上已尝试的步骤,提交前遮住 Key、Cookie、密码和业务资料。

通过小蓝官网联系页咨询接入、对公采购和发票。需要跨应用处理多步骤任务,可继续了解小蓝助手 Blue;本地化部署、培训和技术服务按具体项目确认。使用桌面客户端连接在线模型时,应按所用服务核对资料发送范围。

本文由小蓝助手提供,配置规则参考 Cherry Studio 官方文档,不代表已获 Cherry Studio 官方推荐或合作认证。