Factory Droid 使用哪個配置文件？

推薦使用 ~/.factory/settings.json 配置 WaveSpeed AI。該配置會將 Factory Droid 指向 endpoint /v1/chat/completions。

Factory Droid 應該使用哪個協議？

Factory Droid 應該使用 OpenAI 相容 Chat Completions。本頁使用 endpoint /v1/chat/completions 與該協議匹配。

如何確認 Factory Droid 已經接入成功？

在本地運行 Factory Droid 後打開 WaveSpeed Logs。成功的請求會帶著所選模型和用量資訊出現在 Logs 中。

Agent 設定

將 Factory Droid 接入 WaveSpeed LLM API

複製推薦的 ~/.factory/settings.json 設定，將 Factory Droid 請求路由到 /v1/chat/completions，並在 WaveSpeed Logs 中驗證本機 agent 呼叫。

API Key 測試模型

Factory 的程式設計代理，可將 WaveSpeed 新增為自訂模型。

設定檔

~/.factory/settings.json

協定

OpenAI 相容 Chat Completions

Endpoint

/v1/chat/completions

手動設定

建立 WaveSpeed Access Key

在本機匯出所需金鑰

將設定貼到~/.factory/settings.json

執行 droid exec 並查看 Logs

模型

OpenAI 相容 Chat Completions

用量會顯示在 Dashboard 和 Logs 中

不用改 Agent 程式碼即可切換模型

一行指令完成設定

設定 Factory Droid、檢查是否可用，並備份你原有的設定。加上 --undo 即可還原。

1
安裝 WaveSpeed CLI
npm install -g @wavespeed/cli
2
登入
wavespeed login
3
設定 Factory Droid
wavespeed setup droid

沒有 Node.js？查看其他安裝方式

手動設定

編輯 ~/.factory/settings.json

// File: ~/.factory/settings.json  (add to the existing "customModels" array if you already have one)
{
  "customModels": [
    {
      "model": "deepseek/deepseek-v4.1-flash-1017",
      "displayName": "WaveSpeed deepseek/deepseek-v4.1-flash-1017",
      "baseUrl": "https://llm.wavespeed.ai/v1",
      "apiKey": "${WAVESPEED_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16000
    }
  ],
  "sessionDefaultSettings": { "model": "custom:deepseek/deepseek-v4.1-flash-1017" }
}

不要替換變數名稱

WAVESPEED_API_KEY 是 Agent 讀取的環境變數名稱。設定檔中請保持這個名稱不變，真實 API key 放到你的 shell 環境變數中。

僅目前終端機生效

關閉這個終端機視窗後會失效，適合臨時測試。

export WAVESPEED_API_KEY="wsk_live_..."

重啟後仍然生效

寫入 shell 設定檔，之後新開的終端機也能讀取。

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

將 Factory Droid 接入 WaveSpeed LLM API

本指南說明如何透過 ~/.factory/settings.json、OpenAI 相容 Chat Completions、/v1/chat/completions、base URL https://llm.wavespeed.ai/v1 和預設模型 deepseek/deepseek-v4.1-flash-1017 將 Factory Droid 接入 WaveSpeed AI。複製上方設定，匯出 API key，執行 agent，然後在 Logs 中驗證請求。

將 Factory Droid 接入 WaveSpeed LLM API

手動設定

將 Factory Droid 接入 WaveSpeed LLM API

這個 Factory Droid 設定會配置什麼

常見問題排查

這個 Factory Droid 指南可以被搜尋到嗎？