快速整合(OpenAI 相容格式)
這是最通用的接入方式,支援 API易 全部 400+ 模型。1. 獲取 API 金鑰
請參考 API金鑰獲取與管理教程 獲取您的 API 金鑰。2. 配置步驟

- 開啟 Cherry Studio 應用
- 點選左側的設定圖示進入設定頁面
- 選擇”模型服務”選項
- 在模型提供商列表中建立自定義渠道【API易】
- 填寫配置資訊:
- API 地址:
https://api.apiyi.com - API 金鑰:輸入您的 API易 金鑰(獲取方式)
- API 地址:
- 點選底部的”➕ 新增”按鈕儲存配置
配置要點
- API 地址務必使用:
https://api.apiyi.com - API 金鑰獲取方式請參考 API金鑰獲取與管理教程
- 建議先測試連線確保配置正確
三種渠道型別對比
Cherry Studio 支援多種渠道型別,API易 均可接入。根據您的使用場景選擇最合適的方式:Anthropic 渠道型別
Anthropic 原生格式支援 Prompt Caching(提示快取) 功能,在 5 分鐘內的連續對話中,快取命中的輸入 tokens 僅需正常價格的約 10%,大幅降低使用成本。配置步驟

- 開啟 Cherry Studio 設定 → 模型服務
- 點選底部的”➕ 新增”按鈕,在彈窗中填寫:
- 提供商名稱:自定義命名(如
APIYI-CLAUDE,便於識別) - 提供商型別:選擇 Anthropic
- 提供商名稱:自定義命名(如
- 點選”確定”建立後,在新渠道中填寫配置資訊:
- API 地址:
https://api.apiyi.com - API 金鑰:輸入您的 API易 金鑰
- API 地址:
- 新增所需的 Claude 模型(如
claude-sonnet-4-5-20250929、claude-opus-4-5-20251101)
適用場景
- 連續對話:5 分鐘內的高頻對話,快取命中率高,省錢效果明顯
- 長上下文對話:上下文越長,快取節省的費用越多
- 偶爾聊天:如果您只是時不時發一句,使用 OpenAI 相容格式即可,兩者差別不大
Claude API 詳細文件
檢視 Anthropic 原生格式的完整 API 文件,包括流式響應、擴充套件思考等高階功能。
快取計費深度指南
瞭解 Prompt Cache 如何讓賬單打 1 折,含觸發條件、最小示例與踩坑指南。
Gemini 渠道型別
Gemini 原生格式支援所有 Gemini 專屬功能,包括使用gemini-3-pro-image-preview 進行文生圖(text-to-image) 創作、程式碼執行、原生推理控制等。
配置步驟
- 開啟 Cherry Studio 設定 → 模型服務
- 建立新的渠道,渠道型別選擇 Google Gemini
- 填寫配置資訊:
- API 地址:
https://api.apiyi.com - API 金鑰:輸入您的 API易 金鑰
- API 地址:
- 新增所需的 Gemini 模型(如
gemini-2.5-flash、gemini-3-pro-preview、gemini-3-pro-image-preview)
特色功能
- 文生圖:使用
gemini-3-pro-image-preview模型,直接在對話中生成圖片 - 程式碼執行:模型可自動執行 Python 程式碼進行資料分析
- 推理控制:通過
thinking_budget精細控制推理深度 - 多模態支援:完整支援圖片、音訊、影片等多種媒體輸入
Gemini 原生格式詳細文件
檢視 Gemini 原生格式的完整 API 文件,包括多模態處理、推理控制、程式碼執行等功能。
新增模型
完成渠道配置後,在對應渠道中新增所需模型:- 在模型搜尋框中查詢所需模型
- 點選模型名稱旁的圖示來選擇或配置模型
- 根據需要啟用或停用不同的模型變體
當下熱門模型推薦
檢視最新的模型推薦、效能對比和使用建議。模型列表持續更新,確保您使用最新最強的 AI 模型。
為什麼不在此列出具體模型?AI 模型更新迭代速度非常快,為了確保您獲取最準確的模型推薦資訊,我們統一在 模型推薦頁面 維護最新的模型列表、效能資料和使用建議。
高階功能
圖片支援
如果使用支援圖片的模型(如 GPT-4V):- 在設定中開啟”圖片”選項
- 選擇支援視覺的模型
- 在對話中上傳圖片
流式輸出
Cherry Studio 預設支援流式輸出,提供更好的體驗。故障排除
連線失敗
- 檢查 API 金鑰是否正確
- 確認 API 地址:
https://api.apiyi.com - 驗證網路連線狀態
模型不可用
- 確認賬戶餘額充足
- 檢查模型是否在對應的渠道型別中(例如 Claude 模型需在 OpenAI 或 Anthropic 渠道中)
- 嘗試其他模型
使用技巧
- 合理選擇渠道:根據主要使用的模型選擇對應渠道型別,可同時配置多個渠道
- 合理選擇模型:根據任務需求選擇合適的模型
- 定期更新:關注新模型的釋出
- 監控使用:通過 API易 檢視使用情況