MaiToken
登录/注册

CherryStudio

适用场景：

适合不写代码，主要进行聊天、翻译、内容生成或知识库问答的用户。

开始配置

  1. 打开模型服务： 启动 Cherry Studio，单击左下角的“设置”，进入“模型服务”。

  2. 添加服务商： 在服务商列表底部单击“+ 添加”。

  3. 选择服务商类型： 名称填写 MaiToken，类型选择 OpenAI，然后单击“添加”。

  4. 启用服务商： 在新建的 MaiToken 服务商右侧打开启用开关。

  5. 填写 API 密钥： 在 API 密钥中粘贴您自己的 MaiToken Key。

  6. 填写 API 地址： 输入 https://api.maitoken.com/v1 。这里填写的是 Base URL，不要添加 /chat/completions。

  7. 检查连接： 单击 API 密钥旁边的“检查”。如果检查失败，请先核对 API Key 和 API 地址，不要反复单击。

  8. 添加模型： 进入“模型管理”，单击“+ 添加”，模型 ID 填写 <模型ID>；建议将显示名称设置为 MaiToken - 模型ID。

  9. 开始使用： 回到聊天页面，新建对话，然后从模型选择器中选择 MaiToken 服务商下的模型。

字段 填写内容
提供商名称 MaiToken
提供商类型 OpenAI
API 密钥 <你的 MaiToken Key>
API 地址 https://api.maitoken.com/v1
模型 ID <模型ID>

配置完成后这样测试

  1. 测试普通对话： 在聊天框中输入“只回复 OK”。如果收到正常回复，说明 API Key、API 地址和模型 ID 基本正确。

  2. 测试上下文理解： 输入“总结当前对话中我提供的三个配置参数，不要编造。”

  3. 测试 Agent： 让模型新建一个名为 test-maitoken.txt 的文件并写入 hello，然后确认文件已经生成。请勿使用真实生产项目进行测试。

常见问题

问题 处理建议
检查按钮提示失败 先使用指南中的 curl 或 PowerShell 命令进行接口自检，然后确认 API 地址没有重复添加 /v1。
模型可以添加但无法回复 当前模型 ID 可能不在 API Key 的模型限制范围内，请前往控制台核对模型限制列表。
模型列表拉取失败 可以跳过自动拉取，直接在模型管理页面手动添加准确的模型 ID。