快速接入 Agent
Cherry Studio
Cherry Studio 是跨平台的 AI 桌面客户端，支持添加自定义模型提供商。将 Yomi API 添加为提供商后，即可在本地界面中调用平台目录里的各家模型。
前置准备
- 从 Cherry Studio 官网下载对应系统的安装包并完成安装。
- 在 Yomi API 控制台「秘钥管理」创建密钥并复制保存，密钥仅创建时可见。
配置 Yomi API
- 打开 Cherry Studio 设置，进入模型服务类设置页。
- 添加提供商，类型选择 OpenAI。
- API 地址：填
https://api.yomiapi.com。 - API 密钥：填
YOUR_API_KEY（替换为您的密钥）。 - 在该提供商下添加模型：手动输入模型 id，如
claude-sonnet-5、gpt-5.6-sol、kimi-k3，可按需添加多个。 - 启用该提供商并保存设置。
Cherry Studio 一般会自动在地址后补全
/v1；若您的版本要求填写完整地址，请改填 https://api.yomiapi.com/v1。开始使用与验证
新建对话，在模型选择中切换到刚添加的 Yomi API 提供商下的模型，发送一条测试消息。收到正常回复即接入成功；也可以在 Yomi API 控制台用户中心「用量统计」中确认调用记录。
常见问题
连通性检查失败或返回 404
多为地址拼接问题：先按默认填 https://api.yomiapi.com，若仍失败改填 https://api.yomiapi.com/v1，两种写法对应不同版本对地址的处理方式。
返回 401 认证失败
API 密钥填写有误或已被删除，请到「秘钥管理」核对并更新。
模型列表里找不到想用的模型
Cherry Studio 需在提供商下手动添加模型：输入模型 id（以控制台「模型服务」页或 /v1/models 返回为准），保存后即可在对话中选择。