twinny

twinny 沒有基礎 URL 欄位 — Add provider → OpenAI-compatible server，接著設定 Protocol https、Hostname api.kunavo.com、Port 留白、API path /v1，聊天面板即可使用你的金鑰。

Label          Kunavo
Type           Chat
Provider       OpenAI-compatible server
Hostname       api.kunavo.com
Port           (leave blank — "Blank means the protocol's default")
Protocol       https
API path       /v1
Model name     claude-sonnet-5
FIM template   (Autocomplete only — not part of a Chat provider)
API key        sk-kn-...

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 從側邊欄頂端的機器人圖示開啟 Providers 分頁，或從命令面板執行 Manage twinny providers。
3. Add provider → 在 On your machine 底下，選擇 OpenAI-compatible server 這個通用預設設定。初始設定會指向 localhost:8080。
4. 將 Protocol 設為 https、將 Hostname 設為 api.kunavo.com、清除 Port，並將 API path 設為 /v1。Type 維持設定為 Chat。
5. 將金鑰貼到 API key — twinny 會以 Authorization: Bearer 傳送。接著設定 Model name，可直接輸入，也可透過 Choose from the server's models 選取，因為 Kunavo 會提供 GET /v1/models。
6. 按下 Test provider，接著按下 Use this provider，將其設為目前的聊天供應商。若要複製此列以使用第二個模型，請使用 Copy，無須重新輸入四個端點欄位。

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

除錯用戶端前先驗證

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

# 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 權杖的美元價格，輸入／輸出。

聊天可用；自動補全和索引則不行。

twinny 將工作分為三種供應商類型，且每種類型都要分別設定 — 因此「twinny 可搭配 Kunavo 使用」只對其中一種類型成立。你尚未找到另外兩種類型的設定方式；它們所需的路由並非 Kunavo 提供的路由。

這兩項缺口都不會妨礙此設定，因為 twinny 在每種類型中各自維持一個作用中的供應商，彼此互不影響。twinny 自己的託管 API 頁面稱這種分工為「常見設定」：使用小型本機 base 模型進行補全，同時使用託管模型進行聊天、審查和編輯。工作區索引也採用相同的分工 — 此處不提供嵌入功能，而 twinny 的文件建議改用 Ollama 上的本機模型，例如 nomic-embed-text。不同模型產生的向量無法混用，因此變更該模型時必須重建索引，而非更新索引。