Msty Studio

Model Hub > Model Providers > Add Provider > Open AI Compatible：設定 API Key 與 https://api.kunavo.com/v1 的 Inference Endpoint — 應用程式自己的說明指出，大多數 OpenAI 相容端點需要 /v1。

Model Hub  >  Model Providers  >  Add Provider

Provider             Open AI Compatible     (under "OpenAI Compatible")
Name                 Kunavo                 "Give it a name (optional)"
API Key              sk-kn-...
Inference Endpoint   https://api.kunavo.com/v1      <- keep the /v1

Models               Fetch Models, then tick the ids you want
                     (or Add Custom Model: Model ID + Model Name)
                                                     → Save Provider

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在 Msty Studio 中開啟 Model Hub > Model Providers，然後選擇 Add Provider。在 provider 清單的 OpenAI Compatible 標題下，選擇 Open AI Compatible，而非固定的 OpenAI provider。
3. 為它命名，將金鑰貼入 API Key，並將 https://api.kunavo.com/v1 填入 Inference Endpoint。應用程式要求此欄位的值以 https:// 開頭。
4. 點選 Fetch Models，勾選你要使用的模型。Kunavo 會以 GET /v1/models 回傳完整目錄，因此請選取幾個模型即可，不必全選。你也可以開啟 Add Custom Model，並依目錄中的拼法準確輸入 Model ID，例如 claude-sonnet-5。
5. 點選 Save Provider，接著開啟對話並選取其中一個模型；Msty 自己的文件將此列為測試步驟。若收到回覆，代表端點、金鑰和模型 ID 都正確。

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

除錯用戶端前先驗證

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

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

這裡說的是哪一款 Msty

• Msty Studio——本頁介紹的桌面和網頁工作區，provider 位於 Model Hub > Model Providers。
• Msty Go——獨立的代理程式應用程式，provider 設定頁面位於 Settings；設定說明請見專屬頁面。
• Msty 1.x——已停止維護的應用程式，其凍結文件仍在 docs.msty.app 搜尋結果中排名靠前。它的介面與 Studio 不同。

應用程式失敗時顯示的訊息

以下訊息內建於 2.9.11 版本，以及各訊息對此端點代表的意義：

• 「找不到提供者端點。請確認端點 URL，並確保其中包含正確的 API 路徑，例如 /v1。」——Inference Endpoint 缺少 /v1。
• 「無法連線至提供者端點……」——主機名稱有誤，或是在該用 https:// 的地方用了 http://。
• Fetch Models 失敗，但 URL 正確——請檢查金鑰。Kunavo 的模型清單需要有效金鑰；未提供金鑰時會回傳 401。
• 模型已列出，但聊天時發生錯誤——Msty 自己的表單提醒：「並非所有模型都經過 Msty 測試」。Kunavo 的清單包含圖片、影片和音訊模型，這些模型無法在聊天視窗中使用；請選擇聊天模型。

哪些資料會離開你的裝置

Msty 說明線上提供者可讓你「使用代管模型和自己的 API 金鑰，無須在裝置上執行模型推論」。因此，使用 Kunavo 模型進行對話時，該對話的提示與附加脈絡會傳送至 Kunavo，再由 Kunavo 轉送給模型供應商；使用本機模型進行對話則不會。如果這項資料界線對你很重要，請將敏感內容留在本機模型中。

此 provider 類型的思考強度

Msty 的文件將「OpenAI Compatible Models」的思考強度支援列為「無」與「預設」兩種；其原生 Anthropic 提供者則有「稍微思考」、「適度思考」和「深入思考」選項。透過 Open AI Compatible 類型使用 Claude 模型時，預期它會採用預設推理模式，而非分級選項。