跳转到主要内容

​
准备工作

在开始之前，请确保：
  1. 已安装 Cherry Studio 从 Cherry Studio 官网 下载并安装适合您操作系统的版本
  2. 已获取 ToAPIs API 密钥 登录 ToAPIs 控制台 获取您的 API 密钥（以 sk- 开头）
提示： 如果还没有 ToAPIs 账户，请先在 ToAPIs 注册并获取 API 密钥。

​
配置步骤

​
第一步：打开模型提供商设置

  1. 启动 Cherry Studio
  2. 点击左下角的 设置 图标（齿轮图标）
  3. 在设置页面中选择 模型服务 或 提供商

​
第二步：添加 ToAPIs 提供商

  1. 点击提供商列表右上角的 + 按钮，添加新提供商
  2. 在弹出的对话框中：
    • 名称：填写 ToAPIs（或您喜欢的名称）
    • 提供商类型：选择 New API（兼容 OpenAI 格式）
  3. 点击 确认 完成创建

​
第三步：填写 API 配置

在 ToAPIs 提供商的配置页面中，填写以下信息：
配置项填写内容
API 密钥您的 ToAPIs API 密钥（sk-xxxxxxxxxxxx）
API 地址https://toapis.com/v1/

​
第四步：添加模型

  1. 在提供商配置页面，点击 添加模型 按钮
  2. 填写模型信息：
    • 模型 ID：输入您想使用的模型 ID（见下方推荐模型列表）
    • 端点类型：选择 OpenAI
  3. 点击保存
推荐模型：
模型名称模型 ID特点
Claude Opus 4.6claude-opus-4-6最强大，适合复杂任务
Claude Sonnet 4.6claude-sonnet-4-6性能与速度平衡，推荐日常使用
Claude Haiku 4.5claude-haiku-4-5-20251001快速响应，适合简单任务
GPT-5gpt-5最新 OpenAI 旗舰模型
GPT-4ogpt-4o高质量对话与多模态
GPT-4o Minigpt-4o-mini快速且经济
Gemini 2.5 Progemini-2.5-proGoogle 多模态旗舰
您可以重复上述步骤，按需添加多个模型。

​
第五步：启用并验证

  1. 确保提供商右侧的开关处于开启状态
  2. 点击 检查连接 或 测试 按钮，验证配置是否正确
  3. 如果提示连接成功，说明配置完成

​
开始使用

配置完成后：
  1. 返回 Cherry Studio 主界面
  2. 在对话框顶部的模型选择器中，选择刚才添加的 ToAPIs 模型
  3. 开始对话

​
常见问题

​
Q1: 连接测试失败？

解决方案：
  1. 检查 API 密钥 是否正确，确认以 sk- 开头
  2. 确认 API 地址 填写为 https://toapis.com/v1/（注意末尾的斜杠）
  3. 在 ToAPIs 控制台 确认密钥未过期且账户余额充足
  4. 检查网络连接，确保能访问 https://toapis.com

​
Q2: 模型列表中找不到我的模型？

Cherry Studio 使用手动添加模型的方式，直接在添加模型时输入模型 ID 即可。可在 ToAPIs 模型列表 查看所有可用模型 ID。

​
Q3: 常见错误码说明

错误信息原因解决方法
401 UnauthorizedAPI Key 无效或过期重新获取 API Key
429 Too Many Requests请求频率超限稍等片刻后重试
500 Internal Server Error服务器临时故障等待几分钟后重试
insufficient_quota账户余额不足前往控制台充值

​
支持与帮助

如果您在使用过程中遇到任何问题：
[## 开始使用 ToAPIs 立即注册 ToAPIs，获取您的 API 密钥，在 Cherry Studio 中开启高效 AI 之旅！](https://toapis.com)