Skip to main content

自訂 API 設定

FiloMail 使用自訂 AI 服務商的 API 配置介面

Filo Plus 包含由 Filo 管理的 AI 服務。如果你選擇免費版，也可以在 Filo Desktop 中連接自己的 AI 服務商或本機模型，使用自己的 API 額度繼續使用 Filo AI 功能。

自訂 API 需要在每台 Filo Desktop 裝置上個別設定。使用你設定的服務商不需要訂閱 Filo Plus，但需要服務商支援的模型，以及服務商要求的餘額或計費方式；服務商費用與 Filo 分開結算。

選擇使用 Filo AI 的方式

Filo Plus

最省心的方式。模型、服務和額度均由 Filo 管理，不必維護第三方 API 帳戶、金鑰或帳單。

免費版 + 自訂 API

連接支援的服務商、OpenAI 相容端點或本機模型。Filo 提供 AI 使用體驗，模型與用量則由你的服務商提供及計費。

自訂 API 可以繼續使用的 AI 功能

AI 摘要與自動待辦

摘要單封郵件或完整對話、辨識行動項目，並自動將相關郵件轉成待辦。

AI 對話

根據郵件內容提問、搜尋和分析資訊，並使用所選模型繼續 Filo AI 對話體驗。

AI Compose 與快速回覆

撰寫新郵件、產生回覆、改寫內容，並在寄出前調整語氣與措辭。

翻譯與其他 AI 操作

使用 AI 翻譯，以及目前 Filo Desktop 版本中其他由模型支援的 AI 工具。

開始前請先準備

  • •將 Filo Desktop 更新到最新版本。如果設定中沒有 API Configuration 或 Custom AI（BYOK），表示目前安裝版本尚未包含此功能。
  • •使用雲端服務商時，請先註冊帳戶、依需求啟用計費或儲值，並建立 API Key。ChatGPT、Claude 或 Gemini 的一般消費者訂閱通常不包含 API 用量。
  • •選擇能滿足工作需求的模型。AI 對話和 Agent 操作更適合支援工具呼叫並具備足夠上下文長度的模型。
  • •使用本機服務商時，請先完成安裝、下載模型並啟動本機服務，再回到 Filo 測試連線。

支援的服務商類型

雲端模型服務商

OpenAI、Anthropic、Google Gemini、DeepSeek、xAI、Qwen、Mistral、Z.AI、Doubao、Moonshot、MiniMax、Together、Fireworks、Groq、Cerebras、SambaNova、Nebius 和 Hugging Face。

模型路由與閘道

OpenRouter、Requesty、Vercel AI Gateway、AIHubMix 等相容路由服務，可透過單一帳戶存取一個或多個模型系列。

OpenAI-Compatible

填入 API Base URL、API Key 和正確模型 ID，即可連接自訂 OpenAI 相容服務。支援 https://api.example.com/v1 這類基礎位址，也支援完整的 /chat/completions 位址。

本機與自架服務

Ollama 和 LM Studio 在本機執行，不需要 API Key。LiteLLM 可在本機或遠端部署，API Key 可選；遠端部署必須使用 HTTPS。

每個欄位的意思

Provider

選擇接收 Filo AI 請求的公司或端點。自訂相容端點請選擇 OpenAI-Compatible。

API Base URL

服務商 API 的根位址。官方服務商通常保留預設值即可；自訂或自架服務必須填入正確位址。

API Key

服務商產生的金鑰，不是一般帳戶密碼。Ollama 和 LM Studio 不必填寫；LiteLLM 是否需要則取決於部署設定。

Model

Filo 實際呼叫的模型。對於提供 Model 清單的服務商，Filo 只會顯示同時支援完整 Agent Tool Call 能力與多模態圖片辨識的模型。Filo 需要這兩項能力才能參與郵件處理任務，因此不符合要求的模型不會出現在可選清單中。使用自訂端點時，請選擇同時具備這兩項能力的模型，並輸入正確的模型 ID；服務商要求時須包含 provider/model 這類命名空間。

Reasoning effort

顯示此選項時，Low 較快且通常更省費用，High 會為複雜工作使用更多思考時間和 token；不確定時保留 Medium。

逐步設定自訂 API

  1. 開啟 Filo Desktop，前往設定 → API Configuration。
  2. 搜尋並選擇服務商。自訂相容服務請選 OpenAI-Compatible；本機或自架方案請選 Ollama、LM Studio 或 LiteLLM。
  3. 檢查 API Base URL。官方服務商會預先填入預設位址；OpenAI-Compatible 可填基礎位址或完整 /chat/completions 位址。遠端位址必須使用 HTTPS；Ollama 與 LM Studio 必須使用 localhost 或其他回環位址。
  4. 貼上服務商建立的 API Key。Ollama 與 LM Studio 可略過；LiteLLM 僅在你的部署要求時填寫。
  5. 選擇模型。若沒有模型清單，請輸入服務商或本機服務提供的正確模型 ID。
  6. 若顯示 Reasoning effort，可依需求選擇；不確定時保留 Medium。
  7. 點擊 Test connection。Filo 會送出一個很小的驗證請求，並只在服務商接受設定後儲存憑證。
  8. 服務商狀態顯示 Ready 後，開啟 Enable Custom AI。
  9. 開啟一封郵件，測試摘要、待辦擷取、AI 對話或郵件草稿。日後更改 Key、URL 或模型時，需要重新測試連線。

開啟後會發生什麼

  • •Filo Desktop 中支援的 AI 功能會使用所選服務商和模型，包括摘要、自動待辦、AI 對話、Compose/回覆工具和翻譯。
  • •設定與憑證只儲存在目前裝置，不會自動同步到其他電腦或行動裝置。
  • •關閉 Enable Custom AI 後，Filo 會切回由 Filo 管理的 AI 服務；此時可用性取決於你的免費版或 Filo Plus 權益。
  • •自訂 API 請求不消耗 Filo AI 額度，但並不等於無限使用；仍受服務商餘額、速率限制、模型限制和地區可用性影響。

安全與計費

  • •憑證會安全地儲存在目前裝置，只傳送給你選擇的服務商端點。
  • •為完成 AI 操作，請求可能包含所需的郵件正文、對話內容、草稿、附件內容或待辦資訊。
  • •請勿分享包含 API Key 或授權權杖的截圖或匯出設定。
  • •價格、資料保留、模型訓練、處理地區、速率限制和模型可用性由服務商決定。處理敏感郵件前，請先閱讀服務商的資料政策。
  • •建議使用獨立 API Key，並在服務商後台設定消費上限；若懷疑金鑰外洩，請立即停用並重新產生。

問題排查

  • •出現 401 或 403 表示 Key 被拒絕。請確認 Key 仍有效、屬於目前服務商，並有權使用所選模型。
  • •出現 429 表示達到服務商速率限制或餘額不足。請稍後重試、儲值、提高限額或更換模型。
  • •出現 404 通常代表 Base URL 或模型 ID 有誤。請比對服務商文件，並避免重複加入相同路徑。
  • •若顯示位址遭封鎖或 HTTPS 錯誤，表示端點不符合 Filo 網路安全規則。遠端服務必須使用 HTTPS；Ollama 與 LM Studio 必須使用回環位址。
  • •本機連線失敗時，請確認服務已啟動、連接埠正確，且模型已下載完成。
  • •若一般提問可用但 Agent 操作失敗，請改用支援工具呼叫且上下文視窗較大的模型，再重新測試。
  • •如果沒有 API Configuration 入口，請更新 Filo Desktop，並確認目前版本是否包含此功能。