Obsidian 專用 Copilot

Settings → Copilot → BYOK → Add a custom provider：設定 Display name、你的金鑰與 https://api.kunavo.com/v1 — 一律支援 Quick Chat，若供應商顯示在 opencode 中，也支援 Agent Chat。

Display name             Kunavo
API key                  sk-kn-...
Base URL                 https://api.kunavo.com/v1
Enable CORS              off — see the note below before turning it on
Model ID → Add           claude-sonnet-5
                         claude-haiku-4-5
Search available models  discovery reads GET /v1/models; typed ids also work
Save                     needs at least one model and a routable endpoint

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在 Obsidian 中開啟 Settings → Copilot → BYOK，然後點選 Add a provider。
3. 請選擇 Add a custom provider，不要選擇具名供應商或 Self Host 範本。
4. 依照上述內容填寫 Display name、API key 和 Base URL。目前先不要開啟 Enable CORS。
5. 至少加入一個模型 — 在 Model ID → Add 下輸入 ID，或從 Search available models 中選取；清單會由 GET /v1/models 填入。點選 Test，然後點選 Save；若模型和可路由的端點未同時設定，就無法儲存。
6. 在 Basic → Agents → Quick Chat 和 Basic → Agents → opencode 中設定這些模型的顯示位置；兩者各有自己的 Default model。新加入的聊天模型預設會同時對兩者啟用。

已於 2026年9月21日 根據 Copilot 的 Model Sources and BYOK 頁面 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Obsidian 專用 Copilot 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。