AI API 聚合平台：190+ 大模型、图像与视频模型

Cherry Studio 配置 API 密钥：Base URL、模型与 401/404 排错

更新于 2026-10-30 · apimart.cyou

简答：如果你要在 Cherry Studio 中配置 apimart.cyou，先向该平台确认三项信息：接口协议、Base URL、模型 ID。桌面版进入“设置→模型服务”，移动版进入“设置→模型服务→添加服务商”，填写 Key 和地址后同步或手动添加模型，再执行连接检测；apimart.cyou 当前具体地址和模型名未核实，不能直接照抄第三方示例。

定义：Cherry Studio API 密钥配置，是把服务商提供的认证 Key、接口协议、Base URL 和模型 ID加入模型服务，再通过同步模型或连接检测确认是否可用。

先别猜地址：配置前准备三项信息

本文是面向 Cherry Studio 用户的第三方接入指南，不代表 apimart.cyou 官方。针对 apimart.cyou，本次核验没有找到可公开引用的官方文档来确认当前 API 根地址、默认协议或模型列表，因此本文不提供未经核实的固定地址和模型名称。

如果你手里只有一个 API Key，下一步应先在该平台当前后台或文档中确认以下三项：

  1. 接口协议：例如 OpenAI 兼容、Anthropic 兼容或其他网关协议。
  2. Base URL：用于 API 请求的基础地址，不是登录页、控制台地址，也不是随意复制的完整请求路径。
  3. 模型 ID：平台实际识别的模型名称，不能只根据展示名称猜测。

Cherry Studio 官方文档将服务商按协议区分，并说明未列出的平台可以按自定义服务商方式接入。可参考模型服务配置和自定义服务商。

配置项应从哪里获得不要这样填
协议类型平台 API 文档或接口说明不要因为模型名称像 GPT、Claude 或 Gemini 就随意更换协议
API Key平台的 API 密钥管理页面不要把聊天会员账号、登录密码或邀请码当成 API Key
Base URL平台提供的 API 基础地址不要填登录页、控制台地址或重复拼接完整路径
模型 ID模型列表或平台文档不要只复制展示名称，不要自行翻译或改写 ID

桌面版配置步骤：设置、服务商、模型、检测

以下步骤适用于 Cherry Studio 桌面版的通用模型服务配置。不同版本的按钮名称可能有细微差异；如果你的界面没有对应入口，应以当前软件显示为准。

  1. 打开 Cherry Studio，进入设置→模型服务。
  2. 如果列表中有对应内置服务商，打开该服务商配置页；如果没有，选择添加自定义服务商。
  3. 根据平台说明选择协议类型，例如 OpenAI 兼容或 Anthropic 兼容。
  4. 在 API 密钥字段粘贴 Key，检查首尾是否存在空格、换行或引号。
  5. 按平台说明填写 API 地址。内置服务商通常可保留默认地址；自定义服务商必须填写平台给出的 Base URL。
  6. 点击“获取模型列表”。返回列表后，核对模型名称下方的实际 API 模型 ID，再点击加号加入模型列表。
  7. 打开服务商的启用开关，选择已添加的文字模型，点击“检测”。
  8. 回到新建对话窗口，确认模型选择器中出现该服务商和模型。

Cherry Studio 文档说明，只有加入模型列表的模型才会出现在模型选择器中；“获取模型列表”和“检测”是两个不同动作，前者用于同步或查看模型，后者用于用指定模型验证连接。相关规则见模型服务设置。

移动版怎么配置：入口相同，保存方式不同

Cherry Studio 移动版的入口也是设置→模型服务，但添加服务商时通常先点击添加按钮，再选择内置服务商或自定义服务商。移动版文档当前按 0.3.0 整理，具体界面仍应以你安装的版本为准。

  1. 打开设置→模型服务→添加服务商。
  2. 选择目标内置服务商；如果找不到 apimart.cyou，选择自定义服务商。
  3. 选择与平台一致的接口类型，填写 Base URL 和 API Key。
  4. 同步模型列表，或使用平台提供的准确模型 ID手动添加。
  5. 返回服务商列表，确认开关已启用。
  6. 进入对话或智能体编辑页，选择已启用的服务商和模型，再进行连接检查。

移动版与桌面版的一个重要区别是：移动版已有服务商的名称、地址和密钥开关可能按操作自动保存；密钥编辑弹层通常仍需要点击自己的保存按钮。若从电脑导入配置，导入后仍要检查移动设备是否能访问该 Base URL。

特别注意：如果 API 服务运行在电脑本机，手机中的 localhost 或 127.0.0.1 指向的是手机自己，不是电脑。移动版的服务商、Base URL、模型和密钥规则可参考服务商与模型及快速开始。

Base URL 怎么填：正确、错误与例外情况

Base URL 不能脱离平台文档单独猜测。Cherry Studio 桌面版文档说明，若服务商给出的是类似 https://api.example.com/v1/chat/completions 的完整地址，通常只填写根地址 https://api.example.com，由客户端按服务商类型补充请求路径。

平台提供的地址通常的处理方式常见错误
https://api.example.com按平台协议直接填写未确认接口协议就随意追加路径
https://api.example.com/v1/chat/completions桌面版通常提取为根地址再次自动拼接后变成重复路径
https://api.example.com/v1移动版文档示例允许使用服务商给出的基础地址把 /v1 与客户端规则重复叠加
https://api.example.com/custom-endpoint只有平台明确要求时，才按完整路径处理把普通完整接口路径直接当作所有 Provider 的通用写法
https://api.example.com#仅在平台要求不自动追加版本路径时使用为了“保险”随意添加 #，造成 404

错误拼接示例：平台说明已经给出 https://api.example.com/v1/chat/completions，你又把完整地址填入一个会自动追加 /v1/chat/completions 的 Provider，最终请求可能变成 https://api.example.com/v1/chat/completions/v1/chat/completions。

正确处理：先确认当前 Cherry Studio Provider 的地址拼接规则，再选择根地址、平台指定的基础地址，或在确有明确要求时使用末尾 #。对于 apimart.cyou，当前应以其后台或文档实际显示的地址为准，不要使用上面的示例域名替代真实参数。桌面版规则可查模型服务设置；移动版 Base URL 说明可查服务商与模型。

模型列表为空时：先同步，再按准确 ID 手动添加

配置 Key 和地址后，优先点击“获取模型列表”或移动版的同步模型功能。如果能返回模型，不要只看显示名称，要核对模型条目下方的实际 API 模型 ID。名称相近的日期版、供应商前缀版或别名模型，可能不是同一个调用 ID。

  1. 确认 API Key 已保存并处于启用状态。
  2. 确认协议和 Base URL 与平台文档一致。
  3. 重新获取模型列表，观察是否返回认证、路径或权限错误。
  4. 如果平台不提供模型列表接口，打开手动添加模型功能。
  5. 从平台文档或后台复制准确的模型 ID，填写显示名称和模型类型。
  6. 保存后打开服务商启用开关，再用该模型执行连接检测。

手动添加时，模型 ID必须是平台实际接受的字符串，不能把“旗舰模型”“高速版”这类展示名称直接当作 ID。Cherry Studio 的自定义服务商文档也说明，可以手动添加模型，但模型名称不确定时应回到服务商文档核对。可参考自定义服务商。

成功判定至少包括：连接检测返回成功；所选模型在模型选择器中可见；新建对话能够返回文本。仅能打开设置页面、能保存 Key 或能看到模型名称，都不能单独证明 API 已连通。

401、403、404、429 和超时：按顺序排查

排错时一次只改一个字段，并保留原始错误码和响应提示。不要在余额、权限或模型不存在时无限重试。

现象先检查什么下一步何时停止重试
401 UnauthorizedKey 是否复制完整、是否有空格或引号、认证方式是否匹配重新粘贴 Key，确认服务商类型和认证字段更换 Key 仍持续 401 时，回到平台后台确认 Key 状态
403 Forbidden账户权限、模型权限、来源限制或密钥状态查看平台后台的权限和可用模型，不要只重复生成 Key明确是权限或账户状态问题时停止重试
404 Not Found协议、Base URL、路径是否重复拼接对照平台地址，检查是否重复添加 /v1 或完整路径路径未确认前不要连续更换模型
429 Too Many Requests限速、并发、配额、余额或短时间请求过多查看平台的限速和配额说明；只有临时限流且有明确等待时间时再重试如果提示余额、额度或权限不足，不要自动重试
超时或无法连接地址协议、网络、代理、设备可达性确认使用 https:// 或平台要求的协议；移动端检查手机是否能访问该地址连续超时且无明确响应时，先保存错误信息并联系平台核查
模型不存在实际模型 ID、协议和模型权限从平台模型列表复制准确 ID，重新添加后再检测不要用相似名称反复尝试

如果修改了服务商类型、API 地址或模型 ID，建议保存后重新获取模型列表，再进行一次检测。不要同时修改 Key、地址、协议和模型，否则无法判断是哪一项产生了变化。

多个 API Key、计费与安全：配置前后都要检查

Cherry Studio 桌面版支持为同一服务商配置多个密钥并轮询使用，也支持通过密钥管理入口分别启用、禁用、编辑或删除。桌面版快速输入多个 Key 时，官方文档要求使用英文逗号；移动版文档则建议每个密钥单独添加，不能把多个 Key 粘在同一个输入框中。为了减少误操作，跨设备使用时优先采用独立密钥条目。

Cherry Studio 移动版文档明确提示，应用本身不附带模型额度，平台是否收费及支持哪些模型应以对应服务商为准。检测前先确认计费和额度，尤其不要一开始测试图像或视频模型。

结论：apimart.cyou 的 Key 能否用，取决于四项是否匹配

在 Cherry Studio 中接入 apimart.cyou，最短闭环是：确认接口协议、确认 Base URL、粘贴 API Key、添加准确模型 ID、启用服务商、执行一次连接检测。当前公开资料未核实 apimart.cyou 的固定 API 地址、默认协议和模型 ID，因此不能把搜索结果或其他教程中的参数直接复制过去。

如果只有 Key 没有地址，先回到提供 Key 的平台后台，查找 API 文档、接口说明或模型列表；如果只有地址没有协议，先确认它是 OpenAI 兼容、Anthropic 兼容还是其他网关。只有这四项——协议、Key、Base URL、模型 ID——一致时，Cherry Studio 才有条件完成首次调用。

常见问题

Cherry Studio 的 API 密钥在哪里填写？

桌面版进入“设置→模型服务”，选择内置服务商或添加自定义服务商；移动版进入“设置→模型服务→添加服务商”。在配置页填写 API Key、Base URL 和协议，再同步或手动添加模型。

apimart.cyou 的 API 地址应该填什么？

本次核验没有确认 apimart.cyou 当前可公开引用的固定 API 地址、协议或模型 ID。应以该平台当前后台或文档显示的参数为准，不要照抄其他教程中的域名和模型名。

Base URL 要不要加 /v1？

不能一概而论。桌面版通常会根据服务商类型自动补充路径；移动版文档要求使用服务商给出的基础地址。是否包含 /v1、是否需要末尾 #，必须以当前 Provider 规则和平台文档为准。

模型列表为空怎么办？

依次检查 Key、协议、Base URL 和模型列表权限。如果平台不提供模型同步接口，从平台文档复制准确模型 ID手动添加，再确认服务商已启用并执行连接检测。

Cherry Studio 检测连接会收费吗？

不一定。检测通常会调用所选模型，但是否计费取决于服务商的额度和计费规则。点击检测前，应先查看提供 Key 的平台当前说明。

401 和 404 分别先查什么？

401 先查 Key、认证方式、空格和引号；404 先查协议、Base URL 以及是否重复拼接 /v1 或完整接口路径。每次只修改一个字段，便于定位问题。

桌面版能用，移动版为什么连不上？

先检查移动设备是否能访问同一个 Base URL。如果地址是电脑的 localhost 或 127.0.0.1，手机会把它理解为手机自身，而不是电脑；还要重新确认移动版的密钥保存状态和服务商启用开关。

相关阅读

参考资料

  1. Cherry Studio Docs：模型服务配置（cherryai.com.cn）
  2. Cherry Studio Docs：模型服务设置（cherryai.com.cn）
  3. Cherry Studio Docs：自定义服务商（cherryai.com.cn）
  4. Cherry Studio Docs：服务商与模型（cherryai.com.cn）
  5. Cherry Studio Docs：快速开始（cherryai.com.cn）