Droid API 設定：如何連接自訂 AI 模型

Droid 同時支援內建與外部 AI 模型，讓程式設計任務更具彈性。本指南將帶你完成外部 API 的連接、設定配置、排查常見問題，並使用 Kimi 來驅動 AI 輔助開發。注意：本指南僅適用於 Droid CLI。自訂模型目前僅在 CLI 中受支援，其他 Droid 產品尚無法使用。

使用 Kimi API 連接 Droid

閱讀時長：10分鐘2026-08-12

想在不經過繁瑣設定的情況下，使用自己的 AI 模型來寫程式嗎？Droid 讓這件事變得更簡單，它的 CLI 支援外部 API，讓你可以連接符合自身工作流程的自訂模型。本指南將說明如何設定 API、排解常見問題，以及在 Droid 中使用 Kimi。請繼續閱讀以開始操作。

Droid 是什麼？

Droid 是一款 AI 程式設計工具，可協助開發者更有效率地撰寫程式碼、排解錯誤及處理各項開發任務。它支援內建 AI 模型，也允許使用者透過其 CLI 連接自訂模型，以獲得更高的彈性。無論你需要快速協助，還是更為個人化的設定，Droid 都能適用於不同的程式設計工作流程。

如何在 Droid 中使用內建 AI 模型？

內建 AI 模型讓你無需先連接外部 API，就能輕鬆開始使用 Droid 寫程式。安裝應用程式後，你可以在平台內選擇模型，並開始使用 AI 協助進行程式碼分析、功能開發、錯誤修復與程式碼審查。以下說明如何開始使用 Droid：

步驟一：安裝並開啟 Droid

首先在你的裝置上下載 Factory App 並完成安裝。安裝完成後，開啟應用程式並登入你的帳號。這樣你就能在應用程式中使用 Droid 及其內建 AI 功能。

步驟二：將 Droid 連接到你的專案資料夾

將你的工作目錄設定為想要處理的程式碼庫。這樣可以讓 Droid 與你的本機專案連結，以便讀取檔案、理解程式碼結構，並在更完整的上下文中支援你的開發工作。

步驟三：選擇內建模型並開始輸入提示詞

開啟模型選擇器，從 Droid 提供的內建 AI 模型中選擇一個。選定模型後，你就可以開始輸入提示詞，例如要求它分析程式碼庫、修復錯誤、審查程式碼或開發新功能。

如何將 Droid 連接到外部 API？

將 Droid 連接到外部 API，能讓你更自由地使用自己偏好的模型，而不必局限於內建選項。這項設定是在 Droid CLI 中，透過在設定檔中新增自訂模型來完成，儲存後，該模型就會出現在 /model 選單中供選擇。以下步驟以 Kimi 為簡單示例，帶你了解從取得 API 金鑰到選擇模型的完整設定流程：

步驟一：從 Moonshot AI 取得 Kimi API 金鑰

首先從 Moonshot AI 建立或複製你的Kimi API 金鑰。你需要用到這組金鑰，因為 Droid 會透過它連接 Kimi API，並以你自己的帳號發送請求。建議將金鑰儲存為環境變數，例如 MOONSHOT_API_KEY，以便在設定檔中安全地使用。

步驟二：開啟 Droid 設定檔

接著，開啟 Droid CLI 中用於新增自訂模型的設定檔。在 macOS 上，檔案路徑為 ~/.factory/settings.json；在 Windows PowerShell 中，則使用 %USERPROFILE%\.factory\settings.json。這是 Droid 讀取你自訂模型配置的主要檔案。

步驟三：將 Kimi 新增為自訂模型

在 settings.json 中的 customModels 陣列下新增 Kimi。這會告知 Droid 該使用哪個模型、應呼叫哪個 API 端點、遵循哪種供應商格式，以及使用哪組 API 金鑰進行驗證。如果檔案中已有其他設定，請勿全部取代，只需將這個模型物件新增到現有的 customModels 陣列中即可。

```json { "customModels": [ { "model": "kimi-k3", "displayName": "Kimi K3", "baseUrl": "https://api.moonshot.ai/v1", "apiKey": "${MOONSHOT_API_KEY}", "provider": "generic-chat-completion-api", "maxOutputTokens": 16384 } ] } ```

步驟四：儲存檔案並重新啟動 Droid

新增設定後，儲存檔案並重新啟動 Droid CLI。這樣可確保 Droid 重新載入更新後的設定，並正確辨識新增的自訂模型。

步驟五：在 Droid 中使用 /model 選取 Kimi 模型

打開 Droid CLI 並執行 /model 指令，你的 Kimi 設定應該會出現在「Custom models」區塊中。從清單中選取它，將 Kimi 設為此次程式編寫任務的使用模型。

步驟 6：執行任務

選好 Kimi 之後，就可以在 Droid 中開始實際使用它了。可以試著輸入審查程式碼、修復錯誤或解釋程式庫的提示詞。Droid 會透過 Kimi API 傳送請求，並用該模型來完成任務。

使用 Kimi API 的好處

將 Kimi 連接到 Droid 後，它不再只是 CLI 中的一個外部模型，而是能融入日常開發流程的實用程式編寫助手，無論是小型編碼工作還是較大型的工程任務都能派上用場。以下是使用 Kimi API 的一些好處：

提升開發效率

Kimi 能在你編寫程式碼的過程中生成程式碼、解釋邏輯並提出修正建議，協助你更快完成日常編碼任務。這代表你不需要為了簡單的開發支援而在多個工具間切換。有了 Droid 內建的 Kimi,日常程式設計工作能更快處理完畢。

寫出更可靠的程式碼

Kimi 可以審查你的程式碼、指出可能存在的問題,並協助改善結構,避免小錯誤演變成更大的麻煩。當你想要更清晰的邏輯與更好的可維護性時,這種早期回饋十分有用。長期下來,它能幫助你寫出更易於測試、更新與理解的程式碼。

處理多樣化的開發任務

Kimi 不只能從零開始寫程式碼,還能協助重構、撰寫文件、理解陌生的專案,以及支援不同任務中的功能開發。對於希望用一個 AI 模型協助工作流程各個環節的開發者來說,這使它成為一個靈活的選擇。

連接 API 的常見錯誤排解

在 Droid 中連接外部 API 金鑰通常很簡單,但一些小的設定錯誤仍可能導致問題。大多數問題出在設定檔、供應商名稱、API 金鑰或模型伺服器設定,而非 Droid 本身。好消息是,只要知道該從哪裡下手,這些錯誤通常都很容易解決。

模型未出現在選單中

若使用舊版格式,請檢查 ~/.factory/settings.json 或 config.json 中的 JSON 語法
系統會透過檔案監控自動偵測設定變更
確認自訂模型設定中包含所有必要欄位

「Invalid provider」錯誤

請確認供應商欄位的值恰好是 anthropic、openai 或 generic-chat-completion-api
檢查供應商欄位中是否有拼寫錯誤,並確認大小寫是否正確

驗證錯誤

確認你的 API 金鑰有效且有可用額度
檢查該 API 金鑰是否具有供應商所需的正確權限
確認基礎網址（base URL）與供應商文件中的 API 端點相符

本機模型無法連接

確認你的本機模型伺服器正在執行,例如 ollama serve
確認基礎網址正確,若供應商要求,需包含 /v1/
確認模型已下載或可在本機取得

速率限制或配額錯誤

檢查供應商的 API 速率限制與使用配額
透過供應商的儀表板監控使用量,確認是否已達到限制

結語

在 Droid 中使用自訂 API,能讓你更全面掌控如何運用 AI 建構、測試與改進程式碼。一旦完成設定,就更容易依照符合自身需求的模型來打造程式編寫流程。無論你選擇沿用內建選項,還是連接外部模型,Droid 都提供了一種靈活的方式,將 AI 帶入開發工作。如果你想找個簡單的起點進行自訂設定,不妨在 Droid 中試試 Kimi。它可以是讓日常程式編寫工作更順暢、更快速的實用選擇。

使用 Kimi API 連接 Droid

常見問題

Droid 支援哪些 AI 模型？

Droid 同時支援內建 AI 模型，以及透過其 CLI 新增的自訂模型。外部設定可搭配 Anthropic、OpenAI 及通用聊天補全（chat-completion）API 等供應商類型使用。這讓使用者可以依照自身需求，靈活選用官方 API、部分開源供應商或本地模型。

設定外部 API 需要哪些資訊？

要在 Droid 中設定外部 API，通常需要提供模型 ID、顯示名稱、基礎 URL（base URL）、API 金鑰以及供應商類型。有些設定還可包含選填欄位，例如最大輸出 token 數、額外參數或額外標頭。這些資訊有助於 Droid 正確連接到模型。

我可以在內建與外部 AI 模型之間切換嗎？

可以，Droid 讓你在內建模型與外部模型之間自由切換。內建模型可在應用程式中選擇，而自訂模型在完成設定後，可從 CLI 中的 /model 選單中選取。這樣一來，你可以針對不同的程式設計任務使用不同的模型。

為什麼會出現速率限制或額度錯誤？

這通常表示你的 API 供應商已達到使用量上限、請求上限或計費額度。請前往供應商的後台查看點數、使用量及速率限制。一旦解決額度問題，Droid 中的模型應該就能恢復正常，無需再進行其他設定變更。