已驗證接入教學

Ollama / Ollama Cloud → Cherry Studio

按官方入口和已驗證設定一步一步操作。本站不會替你建立 Key,也不會發送真實模型呼叫。

Ollama 本機原生接入 不需要自己的 Key 已確認值

第 1 步:準備

先準備官方帳號、自己的 Key 或本機環境,再開始填寫設定。

不需要自己的 Key

先打開應用裡正確的設定入口

這裡的選單路徑或指令只有在官方來源已明確證明時才會顯示。先打開正確位置,再填寫下面已驗證的設定值。

照這個路徑打開
設定 模型服務

然後選擇 Ollama / Ollama Cloud

這是已通過公開證據門的應用內入口,不是根據欄位名稱猜出來的。

第 3 步:按欄位填寫設定

先看「這是什麼」,再看要填的值。下面的白話名稱只解釋已驗證設定欄位的用途,不代表應用裡的選單名稱一定完全相同。

以下欄位來自已經驗證的官方接入方式。標為「換成你的值」的欄位必須替換;其他已確認值按原樣填寫。

連線方式 技術欄位: mode
已確認值

告訴工具使用哪種接入模式。已確認的固定值請照原樣填寫。

local_ollama 這是已驗證設定中的固定值,按原樣填寫。
模型 技術欄位: model
換成你的值

告訴工具要使用哪個模型。標為「換成你的值」時,請換成你實際安裝或已經取得使用權限的模型識別碼。

<YOUR_OLLAMA_MODEL> 這是佔位值。請按欄位名稱換成你自己的 Key、模型、位址或其他對應值。
API / 服務位址 技術欄位: apiBase
已確認值

工具會把請求送到這裡。若是「已確認值」,請照原樣填寫;只有顯示為佔位值時才換成你的位址。

http://localhost:11434 這是已驗證設定中的固定值,按原樣填寫。
AI 服務來源(Provider) 技術欄位: provider
已確認值

告訴工具這條連線使用哪個 AI Provider 或本機服務。

ollama 這是已驗證設定中的固定值,按原樣填寫。
查看完整已驗證設定範本
{
    "mode": "local_ollama",
    "model": "<YOUR_OLLAMA_MODEL>",
    "apiBase": "http://localhost:11434",
    "provider": "ollama"
}
4

第 4 步:測試是否成功

儲存設定後,在你自己的應用裡做一次最小測試。本站不會替你發送真實模型呼叫。

  • 儲存設定,並確認應用裡選中的 Provider / 模型就是剛才設定的這一項。
  • 發送一條很短的測試訊息,例如讓模型只回覆「OK」。
  • 能正常收到模型回覆,而且沒有認證、額度或連線錯誤,就表示接入基本成功。
5

第 5 步:出錯時按類型排查

先看錯誤類型,不要反覆更換隨機欄位。

401 / 403:認證或權限

需要 Key 時,檢查是否使用你自己在官方頁面建立的 Key、是否多了空格、帳號或專案權限是否允許。若該接入標記為不需要 Key,確認你沒有誤選雲端或需 Key 的另一種模式。

429 / quota:額度或頻率

回到 Provider 頁面核對免費額度、恢復週期和資格條件。額度用完或觸發限速時,等待恢復或選擇另一個已驗證免費方案,不要假設免費額度無限。

連線失敗 / 模型不可用

逐項對照上面的已驗證欄位、協議和官方文件。若是本機方案,先確認本機服務和模型已經啟動;不要自行猜 Base URL、連接埠或模型名稱。

最近驗證: 2026-10-10 04:15:07