文件

Dyad

Dyad 可透過 Add Custom Provider 接受任何 OpenAI 相容端點：三個欄位、在提供者頁面設定金鑰，然後為你要使用的每個模型 ID 新增一列至選擇器。

Dyad 可透過 Settings → AI Providers → Add Custom Provider 使用任何 OpenAI 相容端點：API Base URL 設為 https://api.kunavo.com/v1，金鑰填在供應商自己的頁面，然後每個模型 ID 新增一列 Add Custom Model。

設定 → AI Providers → Add Custom Provider

Settings → AI Providers → Add Custom Provider
  ID                  kunavo
  Display Name        Kunavo
  API Base URL        https://api.kunavo.com/v1

Then on the new provider's own page
  Set Kunavo API Key  sk-kn-...            → Save Key

Provider page → bottom → Add Custom Model
  Model ID            claude-sonnet-5
  Name                Claude Sonnet 5 (Kunavo)
  Description         Kunavo, OpenAI-compatible
  Max Output Tokens   128000
  Context Window      1000000

基礎 URL 須保留 /v1 — 但並非文件如此規定。 自訂模型頁面只說「通常可在供應商文件中找到 API Base URL」，沒有提供範例，因此無法據此判定。實際發行的應用程式中有兩處資訊可以釐清：對話框本身的提示文字是 E.g., https://api.example.com/v1，而自訂供應商會建構為 OpenAI 相容用戶端，並將您輸入的值原封不動地用作 baseURL — Dyad 只會附加路由，不會附加 /v1。Dyad 自行寫死的所有 OpenAI 相容端點也都以相同方式結尾。若基礎 URL 缺少此部分，會回傳 404，而非金鑰遭拒的錯誤。

文件頁面沒有列出兩個欄位。正式發行的對話框將第一個欄位稱為 Provider ID，而非 ID，並新增了 Environment Variable (Optional) — 例如 KUNAVO_API_KEY 這類變數名稱，只有在設定中未儲存金鑰時才會讀取。該對話框中完全沒有金鑰欄位：先建立提供者、開啟其頁面，再使用頁面上的 Set Kunavo API Key 方框。

請填入 Context Window，不要留空。 Dyad 唯一的警告是，空白欄位會採用「可能低於最佳值的預設值」。實際發行版本的預設值是 128,000 tokens，而 Dyad 會在達到供應商上限與您的 context window 減去 25,000 兩者中較低的值時，壓縮對話。自訂供應商會以 custom:: ID 儲存，因此不受 Google 或 OpenAI 的上限限制，而是採用 250,000 的上限。若留白，百萬 token 的模型會在 103,000 tokens 而非 250,000 tokens 時開始摘要 — 對相同工作多做了數次壓縮，毫無必要。

本設定是根據下方日期時 Dyad 自己的文件和正式發行原始碼整理而成。Kunavo 尚未使用 Dyad 連線至其端點進行測試 — 不論是建置、串流編輯或 Agent 模式工具往返呼叫，這個系列中的其他用戶端也都一樣。發布設定頁面不等於通過相容性測試。嘗試此設定時，請保留目前可用的路徑，並先測試一項範圍明確的功能，再將專案移至此設定。

Kunavo 不提供 embedding、文字轉語音或語音轉文字模型，因此透過此方式新增的自訂提供者只能回應聊天完成請求。Dyad 的建置循環不會要求另外三種功能，因此在此不會造成任何功能損失 — 這只代表你剛新增的提供者無法直接替代同時需要這些功能的技術堆疊。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Dyad 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
在 Dyad 中，前往 Settings，找到 AI Providers 區段，然後點選 Add Custom Provider。依照上方說明填入 ID、Display Name 和 API Base URL。ID「會在內部使用，之後無法變更」，因此請選擇適合長期使用的名稱；Display Name 則會顯示在選擇器中，只影響顯示名稱。
開啟剛建立的提供者，將金鑰貼入 Set Kunavo API Key，然後按一下 Save Key。若基本 URL 留白，Dyad 會直接以 missing the API Base URL 錯誤拒絕請求，而不會造成網路失敗。
在同一頁向下捲動到底部，然後點選 Add Custom Model。Model ID 必須與目錄中的 slug 完全相同 — Dyad 文件指出，它「必須與供應商 API 文件中的指定內容完全一致。這是傳送至 API 的識別碼」— 因此請使用 claude-sonnet-5，而非顯示名稱。
請依據 /models 填寫 Max Output Tokens 和 Context Window，不要留白；然後對選擇器中想使用的每個 ID 重複執行 Add Custom Model — 這裡沒有批次匯入功能，也不會取得模型清單。
在模型選擇器中選取新模型，並交給它實際任務 — 例如新增元件，而不是打招呼。Build 模式是代理循環，每一步都會重新傳送工作集，因此首次執行應測試串流和重複編輯。

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

這是簡短版本。完整指南——模型選擇、實際工作階段費用，以及失敗情況——請參閱 Dyad 定價與 API 成本指南。

除錯用戶端前先驗證

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

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

模型 ID	Kunavo 輸入／輸出	它在 Dyad 中的位置
`claude-sonnet-5`	$1.40 / $7.00	預設的 Build 模式模型 — 適合全天執行循環的每美元程式碼品質
`claude-opus-5`	$3.50 / $17.50	在重構工作中使用 Plan 模式，錯誤計畫會耗掉整個工作時段
`claude-haiku-4-5`	$0.70 / $3.50	Ask 模式和程式碼庫快速問答，使用量是主要考量
`gpt-5-6-sol`	$2.00 / $12.00	從另一個系列取得第二意見 — 在同一提供者下新增為第二個自訂模型
`gpt-5-6-terra`	$0.70 / $4.20	填妥 Context Window 欄位後，即可使用大型工作集

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

切換前需了解的三項限制

這些是 Dyad 自身的規則，並非 Kunavo 的規則，而且每一項都會影響客戶金鑰可存取的功能。這就是本頁說明如何連線至模型，而非所有 Dyad 功能的原因。

依照設計，無法透過自有金鑰使用 Pro 模式。Dyad 的定價常見問題明確指出：像 Smart Context 這類 Pro 模式只能使用 Dyad Pro 的 AI 點數，不能使用自有 API 金鑰，因為這些功能需要在伺服器端跨多個模型處理。Turbo Edits 也是如此。自訂提供者可讓你使用模型和一般模式，但無法使用這些功能。
免費方案的 Agent 模式有使用上限。每 23 小時期間最多可傳送 20 則 Agent 訊息，無論設定的是誰的金鑰都適用 — Build、Ask 和 Plan 則沒有上限。因此，工作階段中途意外停止，原因可能是 Dyad 的配額限制，而不是你的餘額或端點問題。
Dyad 無法使用 Anthropic Messages 通訊協定。自訂提供者一律會建構為 OpenAI 聊天完成用戶端，而內建 Anthropic 提供者不接受基本 URL 覆寫。因此 Claude 模型會透過 OpenAI 相容介面連線 — 上述設定就是如此，這也是為什麼本頁使用 OpenAI 格式的驗證請求。

常見問題

如何在 Dyad 中新增自訂 API 提供者？

前往 Settings，找到 AI Providers 區段，然後按一下 Add Custom Provider。填寫 ID（供內部使用，之後無法變更）、供選擇器顯示的 Display Name，以及端點的 API Base URL。儲存後，開啟剛建立的提供者，將金鑰貼入其頁面上的 "Set <name> API Key" 方框 — 金鑰不屬於建立對話框中的欄位。最後，捲動至該頁面底部，對每個想使用的模型 ID 各執行一次 Add Custom Model。Dyad 文件以一句話說明端點方面的要求：只要提供 OpenAI 相容 API，任何提供者都能使用。

Dyad 的 API Base URL 結尾需要加上 /v1 嗎？

對 OpenAI 相容端點而言需要 — 例如 https://api.kunavo.com/v1。Dyad 的 Custom Models 文件無法解答這個問題：只提到通常可以在提供者文件中找到 API Base URL，沒有提供範例。真正能確認答案的是對話框本身，其預留位置文字為 "E.g., https://api.example.com/v1"，以及 Dyad 建構用戶端的方式 — 你的值會原封不動地成為 OpenAI 相容用戶端的 baseURL，並只附加路由。基本 URL 若缺少 /v1，會導致 404，而非驗證錯誤；若已包含 /chat/completions，也會出現相同結果。

我可以在沒有 Anthropic 帳戶的情況下，透過 Dyad 使用 Claude 模型嗎？

可以，透過自訂提供者，而不是 Dyad 內建的 Anthropic 項目。Dyad 會將每個自訂提供者建構為 OpenAI 聊天完成用戶端，因此你輸入的模型 ID 會由設定的端點解析，而非由應用程式解析；Claude ID 也可以傳送至該端點。內建 Anthropic 提供者則無法達成此目的：其建構時未提供基本 URL 引數，因此沒有 ANTHROPIC_BASE_URL 式的覆寫選項，只會連至 Anthropic 自己的端點。

Dyad 中的自訂提供者和使用 OpenRouter 有什麼不同？

差異只在設定方式，而非本質。OpenRouter 是 Dyad 提供者清單中唯一內建預設設定的獨立多廠商閘道，因此只需要金鑰；其他閘道都要透過 Add Custom Provider 新增，並手動輸入每個模型的 ID、Max Output Tokens 和 Context Window。當某個閘道要求被加入預設清單時，Dyad 維護者明確指出的正是這條路徑。比較兩者時，應考量價格、儲值條件和你實際想用的模型，而不是清單上有沒有它的標誌。

為什麼我的 Dyad 自訂模型這麼早就開始摘要對話？

因為 Context Window 欄位可能留白了。欄位空白時，Dyad 會使用 128,000 tokens 的預設值，並在每個提供者的上限與 context window 減去 25,000 之中，選取較低者來壓縮對話；自訂提供者使用的是 250,000 上限，而非 Google 或 OpenAI 的上限。因此，即使模型的 context window 大得多，留白也會讓壓縮約在 103,000 tokens 時開始。請將提供者目錄中的實際數值填入 Max Output Tokens 和 Context Window，壓縮門檻就會移至上限。