準備工作
在開始之前,請確保:- 已安裝 Cherry Studio 從 Cherry Studio 官網 下載並安裝適合您操作系統的版本
-
已獲取 ToAPIs API 密鑰
登錄 ToAPIs 控制檯 獲取您的 API 密鑰(以
sk-開頭)
配置步驟
第一步:打開模型提供商設置
- 啓動 Cherry Studio
- 點擊左下角的 設置 圖標(齒輪圖標)
- 在設置頁面中選擇 模型服務 或 提供商
第二步:添加 ToAPIs 提供商
- 點擊提供商列表右上角的 + 按鈕,添加新提供商
- 在彈出的對話框中:
- 名稱:填寫
ToAPIs(或您喜歡的名稱) - 提供商類型:選擇 New API(兼容 OpenAI 格式)
- 名稱:填寫
- 點擊 確認 完成創建
第三步:填寫 API 配置
在 ToAPIs 提供商的配置頁面中,填寫以下信息:| 配置項 | 填寫內容 |
|---|---|
| API 密鑰 | 您的 ToAPIs API 密鑰(sk-xxxxxxxxxxxx) |
| API 地址 | https://toapis.com/v1/ |
第四步:添加模型
- 在提供商配置頁面,點擊 添加模型 按鈕
- 填寫模型信息:
- 模型 ID:輸入您想使用的模型 ID(見下方推薦模型列表)
- 端點類型:選擇 OpenAI
- 點擊保存
| 模型名稱 | 模型 ID | 特點 |
|---|---|---|
| Claude Opus 4.6 | claude-opus-4-6 | 最強大,適合複雜任務 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | 性能與速度平衡,推薦日常使用 |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 | 快速響應,適合簡單任務 |
| GPT-5 | gpt-5 | 最新 OpenAI 旗艦模型 |
| GPT-4o | gpt-4o | 高質量對話與多模態 |
| GPT-4o Mini | gpt-4o-mini | 快速且經濟 |
| Gemini 2.5 Pro | gemini-2.5-pro | Google 多模態旗艦 |
第五步:啓用並驗證
- 確保提供商右側的開關處於開啓狀態
- 點擊 檢查連接 或 測試 按鈕,驗證配置是否正確
- 如果提示連接成功,說明配置完成
開始使用
配置完成後:- 返回 Cherry Studio 主界面
- 在對話框頂部的模型選擇器中,選擇剛纔添加的 ToAPIs 模型
- 開始對話
常見問題
Q1: 連接測試失敗?
解決方案:- 檢查 API 密鑰 是否正確,確認以
sk-開頭 - 確認 API 地址 填寫爲
https://toapis.com/v1/(注意末尾的斜槓) - 在 ToAPIs 控制檯 確認密鑰未過期且賬戶餘額充足
- 檢查網絡連接,確保能訪問
https://toapis.com
Q2: 模型列表中找不到我的模型?
Cherry Studio 使用手動添加模型的方式,直接在添加模型時輸入模型 ID 即可。可在 ToAPIs 模型列表 查看所有可用模型 ID。Q3: 常見錯誤碼說明
| 錯誤信息 | 原因 | 解決方法 |
|---|---|---|
401 Unauthorized | API Key 無效或過期 | 重新獲取 API Key |
429 Too Many Requests | 請求頻率超限 | 稍等片刻後重試 |
500 Internal Server Error | 服務器臨時故障 | 等待幾分鐘後重試 |
insufficient_quota | 賬戶餘額不足 | 前往控制檯充值 |
支持與幫助
如果您在使用過程中遇到任何問題:[## 開始使用 ToAPIs 立即註冊 ToAPIs,獲取您的 API 密鑰,在 Cherry Studio 中開啓高效 AI 之旅!](https://toapis.com)