全部教程 /
在 Cherry Studio 中使用 XHuoAPI
Cherry Studio 官方明确表示不再内置聚合类服务商，统一走「自定义 Provider」接入。配置方式和内置 OpenAI 一样。
开始之前
先验证一下
curl https://api.xhuoapi.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'
配置步骤
1
设置 → 模型服务，点底部的 + 添加。名称随意，供应商类型选 OpenAI。
2
填 API 密钥和 API 地址。Cherry Studio 会自动补 /v1/chat/completions，所以地址只填域名。
API 地址 / API address: https://api.xhuoapi.ai API 密钥 / API key: sk-...
3
点「获取模型列表」，在弹出的模型管理里点右侧 + 把要用的模型加进来。只有加进列表的模型才会出现在应用各处的选择器里。最后打开右上角的启用开关。
注意事项
地址以 # 结尾时 Cherry Studio 不再自动补路径，只用你填的完整地址。一般用不到，除非上游路径不是标准的 /v1/chat/completions。
模型名下方会显示上游返回的真实 ID。名字相近的版本不会合并，添加前看一眼 ID 别选错。
Qwen 系列与图像/视频模型只在 Standard 与 Official 分组可用。令牌建在 Saver 或 Spot 分组下时，这些模型会返回「模型不可用」。