本文件為英文原版的機器翻譯。若翻譯版本與英文原版之間存在任何歧義,概以英文原版為準。 閱讀英文原版


AI 提供商與 API 金鑰

Caiioo 透過少數幾家提供商連接到 500 多個 AI 模型。您自備 API 金鑰 — 這意味著您直接向提供商付費,Caiioo 絕不會經手您的支出。

支援的提供商

目前普遍提供兩家提供商:

  • OpenRouter(預設)— 單一金鑰即可解鎖 500 多個模型,包括 Anthropic Claude、Google Gemini、OpenAI GPT、Mistral、Groq、Llama 等。這是大多數使用者的推薦路徑 — Caiioo 的工具依賴 OpenRouter 的模型註冊表,且您只需管理一個金鑰。
  • Ollama — 在您的機器上本機執行開源模型。完全私密,無需網路,FREE。適用於離線工作或當您想要絕對控制推理過程時。

直接連接 Anthropic、Google Gemini、OpenAI、Poe 和 MLX 的功能已在計劃中,但尚未正式發布。目前,請透過您的 OpenRouter 金鑰使用這些模型 — 這正是 OpenRouter 的用途。

請參閱 使用條款 以了解相關政策。

開始使用(兩種選項)

選項 1:使用免費提供的金鑰

我們提供了一個免費的 OpenRouter 金鑰,讓您可以立即嘗試 Caiioo。它可以存取特定的免費模型並設有用量限制 —— 非常適合進行測試。

若要持續使用:只需打開 Caiioo 並開始對話即可。無需任何設定。Pro 訂閱者每月可獲得額外 $5 美元的 OpenRouter 額度獎勵,該獎勵會自動套用到同一個金鑰上,並疊加在現有餘額之上。

消耗額度的工具 —— 圖像、影片和音樂生成、進階 OCR 以及 Perplexity AI 搜尋 —— 需要的是 OpenRouter 額度,而不僅僅是金鑰。在免費提供的金鑰上,這些工具會顯示「無額度」。您有兩種解決方案:在「Settings > AI Providers」中輸入您自己的 OpenRouter API 金鑰 (BYOK),或者升級您的 Caiioo 方案 —— 付費方案每月會為這個提供的金鑰充值額度,讓這些工具可以直接運作。

選項 2:自備金鑰 (BYOK)

想要不受免費層級限制的完整存取權限嗎?請添加您自己的金鑰。

OpenRouter(推薦):

  1. openrouter.ai 註冊並建立一個 API 金鑰
  2. 前往 Settings → AI Provider
  3. 選擇 OpenRouter 並貼上您的金鑰
  4. 大功告成 —— 金鑰會保留在您的裝置上,絕不會傳送到 Caiioo 的伺服器

Ollama(本地):

  1. ollama.com 安裝 Ollama 並下載模型(ollama pull llama3.2
  2. 前往 Settings → AI Provider
  3. 選擇 Ollama 並確認伺服器 URL(預設為 http://localhost:11434
  4. 選擇任何您已在本地安裝的模型

當您選擇本地對話模型時,若 AI 驅動的工具需要將您的資料傳送到遠端 AI 提供商,系統會先徵求您的同意。請參閱 Privacy & DataRemote AI Providers

Model Configuration showing Default Model and Max Steps

快速任務模型 (Quick Tasks Model)

這是一個獨立且更便宜的模型,Caiioo 會在背景自動使用它來處理諸如生成對話標題、分類意圖、選擇要調用的工具以及其他簡短的輔助查詢 —— 您永遠不會直接對它下指令。請在 Settings → Model Config 中進行設定(一個小型的 OpenRouter 免費模型或本地 Ollama 模型就足夠了)。如果未設定,系統將退而使用您的預設模型。

工具自備認證 (BYOA) — Pro

BYOA 與 BYOK 不同。它不是用於 LLM,而是用於 工具連線(Google Workspace、Microsoft 365、GitHub 等)。在 Pro 方案中,當您的組織不允許將 Caiioo 的預設用戶端 ID 加入白名單時,設定 → 自定義 OAuth 允許您插入自己的 OAuth 用戶端:

  • Google Workspace 精靈 — 引導您建立 Google Cloud 專案並貼入用戶端 ID + 密鑰
  • Microsoft 365 精靈 — 針對 Azure 註冊應用程式的相同流程
  • 新增自定義提供商 — 適用於任何支援 OAuth 2.0 的提供商的通用流程

這些精靈會將憑證直接寫入憑證保險箱。它們絕不會離開您的裝置。

API 金鑰安全性

您的 API 金鑰儲存在您的裝置本機。它們絕不會被發送到 Caiioo 伺服器。當您發出請求時,您的金鑰會直接發送到 AI 提供商。請參閱 隱私與數據 以了解完整說明。

效能取決於您的模型

Caiioo 負責編排工作 — 工具、上下文、多步驟工作流。但 AI 回應的品質取決於您選擇的模型。

對於複雜任務(研究、分析、長文件):請使用頂尖模型 — Claude Sonnet、GPT 等級或 Gemini Pro — 這些都可以透過您的 OpenRouter 金鑰存取。它們處理多步驟推理和工具呼叫的效果最好。

對於快速回答(問題、摘要、簡單編輯):快速模型 — Claude Haiku、較小的 GPT 或 Gemini Flash 變體 — 更便宜且更快速。非常適合日常任務。

對於實驗:OpenRouter 讓您只需一個 API 金鑰即可嘗試 500 多個模型。找到最適合您工作流程的模型,而無需綁定單一提供商。

對於離線 / 完全私密的工作:Ollama 在您的機器上執行開源模型。雖然比雲端頂尖模型慢,但任何數據都不會離開您的硬體。

Caiioo 的工具、上下文層和編排功能會放大您所選模型的效能。一個好的模型在擁有正確的上下文和工具配合時,會變得非常出色。

延伸閱讀


This guide is maintained by the Caiioo team using Slate, our built-in editor.