TypingMind

Models → Add custom model：完整 Endpoint URL https://api.kunavo.com/v1/chat/completions、包含 Bearer 與你的金鑰的 Authorization 標頭、Model ID 及其上下文長度 — 每個模型一個項目，直接從瀏覽器呼叫。

Models  →  Add custom model  →  Create Manually

Name                    Kunavo · Claude Sonnet 5
Model ID                claude-sonnet-5
Context Length          1000000

Authentication tab
  API Type              OpenAI Chat Completions API
  Endpoint URL          https://api.kunavo.com/v1/chat/completions
  Authentication Type   API Key via HTTP Header
    Header Key          Authorization
    Header Value        Bearer sk-kn-...

Capabilities tab        tick only what you have checked (see below)
Request Options tab     leave "Route requests via TypingMind Cloud" off

                        → Test & Save

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在 TypingMind 中，從左側邊欄開啟 Models，然後按一下 Add custom model。維持選取 Create Manually；Import JSON 和 Import OpenRouter 適用於其他來源。
3. 填入 Name（任意名稱）、Model ID（必須與 GET /v1/models 列出的內容完全一致 — 例如 claude-sonnet-5）以及 Context Length。表單預先填入 128000；請根據模型頁面填入模型實際的上下文視窗，因為 TypingMind 會依此決定要傳送多少對話記錄。
4. 在 Authentication（驗證） 分頁中，選擇 API Type（API 類型） = OpenAI Chat Completions API，貼上完整的 Endpoint URL（端點 URL），將 Authentication Type（驗證類型） 設為 API Key via HTTP Header，並在 Header Key（標頭鍵） 輸入 Authorization，在 Header Value（標頭值） 輸入 Bearer sk-kn-... ——也就是 Bearer、空格，再加上金鑰。
5. 在 Capabilities 中，您可以手動勾選功能，或保持啟用 Auto check capabilities on save；表單說明，儲存時會傳送「幾個測試請求」，並因此計費少量 token。您也可以選擇在 Pricing 中填入下表的每百萬 token 費率，讓 TypingMind 的成本顯示與您的帳單一致。接著點選 Test & Save。
6. 每個模型都要重複上述設定。自訂端點沒有供應商層級的項目：Claude Sonnet、Claude Haiku 和一個 GPT 模型，是三個獨立的自訂模型，但使用相同的 Endpoint URL 和標頭。

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

除錯用戶端前先驗證

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

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

另外三種 API 類型

目前的表單中，API Type 下拉選單提供 OpenAI Chat Completions API、OpenAI Responses API、Claude Messages API 和 Gemini API。Kunavo 支援前三種；每種都需要在 Endpoint URL 填入各自的完整路徑。

• Claude Messages API —— Endpoint URL https://api.kunavo.com/v1/messages。TypingMind 自己的 Claude 格式範例使用 x-api-key 標頭；Kunavo 在此路徑接受該標頭或 Authorization: Bearer。此路徑僅提供 Claude 系列 ID。
• OpenAI Responses API —— Endpoint URL https://api.kunavo.com/v1/responses，使用相同的 Bearer 標頭。TypingMind 的文件沒有此類型的完整範例，因此完整路徑格式是根據另外三種推斷而來，並非文件引述。
• Gemini API —— 此端點不適用。它需要 Google 原生的請求格式；請改用 Chat Completions 類型呼叫 Gemini 模型。

這不是 TypingMind API

「TypingMind API」通常指 TypingMind Teams 執行個體（custom.typingmind.com）的 REST API，用來管理該聊天執行個體。它不販售模型 token，也與此設定無關。自訂模型只是讓 TypingMind 使用您提供的金鑰呼叫其他服務的端點。

兩筆分開的費用

TypingMind 授權費用是用來支付應用程式。你透過自訂模型傳送的每則訊息，都會由標頭中的金鑰持有人按 token 計費——此處是 Kunavo，費用從預付餘額扣除。TypingMind 的授權方案，以及依這些費率計算的每月聊天費用，詳見 TypingMind 價格與 API 費用。

Test & Save 失敗時

• 404，並顯示「POST /v1 is the base URL, not an endpoint」（或當 URL 只到主機時顯示「Not found: /」）——Endpoint URL 缺少路徑。結尾必須是 /v1/chat/completions（這些類型則為 /v1/messages、/v1/responses）。在 2026 年 10 月 1 日之前，這兩種情況都會回傳 HTML 頁面。
• 404，並顯示「No such endpoint」——路徑拼寫錯誤，例如 /v1/chat/completion。相同訊息也會指出 Kunavo 提供的最相近路徑。
• 404，並顯示「Not found: /chat/completions. Kunavo's API lives under /v1」——路徑存在，但缺少 /v1：Endpoint URL 顯示為 https://api.kunavo.com/chat/completions。請在路徑前加上 /v1。（已於 2026 年 10 月 1 日確認；在該日之前，同樣的錯誤會回傳 HTML 頁面。）
• 401「Missing or invalid API key」——標頭設定錯誤：Header Key 必須是 Authorization，且值必須以 Bearer 開頭，或是該金鑰已遭撤銷。
• 模型無法使用錯誤——Model ID 的拼法與 GET /v1/models 列出的不同。ID 一律使用小寫並以連字號分隔。
• 瀏覽器主控台中的網路或 CORS 錯誤——確認 Endpoint URL 是 https://api.kunavo.com，而非網站網域；會傳送 CORS 標頭的是 API 主機。