Factory Droid

在 ~/.factory/settings.json 中設定 customModels 項目 — model、baseUrl 與 provider — 讓 Droid 使用任何支援 Anthropic Messages 或 OpenAI Chat Completions 的端點。

// ~/.factory/settings.json  (Windows: %USERPROFILE%\.factory\settings.json)
{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "Sonnet 5 [Kunavo]",
      "baseUrl": "https://api.kunavo.com",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "anthropic"
    },
    {
      "model": "gpt-5-6-sol",
      "displayName": "GPT-5.6 Sol [Kunavo]",
      "baseUrl": "https://api.kunavo.com/v1",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "generic-chat-completion-api"
    }
  ]
}

// Then, in the shell Droid starts from:
//   export KUNAVO_API_KEY=sk-kn-...
// ${VAR_NAME} expansion is a settings.json feature. It does NOT apply to the
// legacy ~/.factory/config.json, which Factory still loads and merges.

逐步操作

1. 在 /app/keys 建立金鑰並複製 — 金鑰只會顯示一次。在啟動 Droid 的 shell 中將其匯出為 KUNAVO_API_KEY，這樣金鑰本身就不會寫入設定檔。
2. 開啟 ~/.factory/settings.json（若檔案不存在就建立），並加入上方的 customModels 陣列。Factory 明確標示三個必填欄位 — model、baseUrl 和 provider — 而 displayName 是選擇器中顯示的標籤。
3. 檢查 provider 的拼字。它必須完全符合 anthropic、openai 或 generic-chat-completion-api 其中之一；Factory 的疑難排解章節指出，此處拼字錯誤會導致 "Invalid provider" 錯誤。
4. 在 CLI 中執行 /model。你的項目會出現在 Factory 自有模型下方的獨立 Custom models 區段中，並以你設定的 displayName 標示。Factory 會監看設定檔，因此儲存後就會生效 — 不必重新啟動。
5. 請給它一項需要讀取並編輯檔案的任務，而非只打招呼。Droid 幾乎所有操作都依賴工具呼叫，而一般聊天回合無法測試這部分。接著執行 /cost，Factory 會在此處回報快取命中率 — Kunavo 原生支援 Anthropic 的 cache_control 標記，而 Factory 自己也指出，對通用 Chat Completions 供應商而言，快取「因供應商而異，無法保證」。

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

除錯用戶端前先驗證

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

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

欄位中應填入哪個模型 ID

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

Droid 中的自訂模型無法涵蓋哪些情況

有三項限制來自 Factory 自家的頁面，每一項都會影響你對上述設定的預期，但不影響它是否能運作。

• 僅限本機介面。 Factory 的 BYOK 頁面指出，自訂模型可用於 Droid CLI 和桌面應用程式，兩者會讀取本機的 settings.json；這些模型「不會出現在 Factory 託管的網頁版或行動平台」。透過託管產品委派的工作，仍會使用由 Factory 計費的推論服務執行，不受您在此設定的金鑰影響。
• 管理員可以將它關閉。 Factory 的企業控制文件說明了 modelPolicy.allowCustomModels 和 allowedBaseUrls，前者會完全停用使用者的 BYOK，後者則會將所有自訂模型限定在一個核准的主機上。在受管理的裝置上，請先確認這點，再開始檢查檔案。
• 方案費用仍然存在。 在此使用金鑰是額外增加，而非取代方案 — Factory 對超出 BYOK 額度的用量收取多少費用，以及額度是多少，請參閱費用指南；本頁不會重新推算這些資訊。

在任何地方複製設定之前，有個容易踩到的陷阱值得先知道：Factory 仍會載入舊版 ~/.factory/config.json，其中使用 snake_case 格式的 custom_models 和 base_url，並將其合併到 settings.json 之下；Factory 也有說明，${VAR_NAME} 展開功能不適用於該檔案。若在該檔案中以佔位文字填入金鑰，該文字會照原樣送出。請使用 settings.json。