Agent 接入

Cherry Studio + 星模XModel

Cherry Studio 以「模型服务」组织接入:新增一个 OpenAI 兼容服务商,API Host 填星模XModel 端点,Key 填你的 Key,再添加模型 ID 即可在对话里使用。

桌面客户端 · 厂商:Cherry Studio

快速开始

分步接入

  1. 1前置条件:获取 API Key

    注册星模XModel 后,在控制台「API 密钥」页创建一个 Key。下文所有 YOUR_API_KEY 占位符都替换为你的 Key;Key 等同账户凭证,不要提交进仓库。

    打开 /docs/quickstart 文档

  2. 2设置 → 模型服务 → 添加

    提供商类型选 OpenAI 兼容,名称随意(如 星模XModel)。

  3. 3填 API Host 与 Key

    Cherry Studio 设置
    API Host: https://modelxing.com/v1
    API Key:  YOUR_API_KEY
  4. 4添加模型并对话

    在模型管理里添加 qwen/qwen3-max,回到对话页选择它发起第一条消息。

示例提示词

配好后直接粘贴

复制任意一条发给刚配好的 Agent,验证接入是否生效。

提示词
把这段会议记录整理成带负责人的行动项列表。
提示词
对比两个方案的成本与风险,给出推荐结论。

常见问题

FAQ

API Host 应该填到哪一级?

填到 /v1(即 https://modelxing.com/v1),Cherry Studio 会自动拼 chat/completions 路径。

能同时配多个服务商吗?

可以,Cherry Studio 支持多服务商并存,对话里按模型切换。

故障排查

出问题时先看这里

测试连接失败

检查 API Host 是否带了多余路径或少了 /v1;Key 是否完整。

对话报模型不存在

模型 ID 要用网关发布的 ID(如 qwen/qwen3-max),不是服务商展示名。