配置模型

摘要

Bot 可使用套餐模型積分或自有服務商憑證。可以設置一個主模型、多個備用模型，也可僅保存模型。API Key 在服務商後台創建，不由 LightVela 生成。

先確認套餐是否已包含可用模型

部分 LightVela 套餐包含可直接使用的模型及模型積分。若當前套餐權益有效、仍有可用額度，且所需模型在套餐支持範圍內，可先在網頁對話中使用，無需先填寫自己的 API Key。 可用模型、額度、有效期及消耗規則以當前套餐與模型頁面為準；並非所有套餐都包含所有模型。

需要套餐之外的模型，或希望使用自己的服務商額度時，再按下文配置。這裏的套餐內置模型與「模型 Coding Plan」頁籤中的第三方模型套餐不同：後者需要相應服務商的 API Key。

開始前

登錄後選擇目標 Bot，打開「管理 → 模型」。確認 Bot 已就緒；網頁對話無需先連接聊天通道。使用自有模型時，準備有效的 Key 和服務商額度。

配置模型

1. 選擇「模型 Coding Plan」「模型 API」或「自定義模型」頁籤，再選擇服務商。
2. 若有「點此獲取 API Key」外鏈，在服務商後台創建 Key，回到 LightVela 填入。
3. 選擇目錄中的模型；服務商支持在線發現時，可點擊「獲取可用模型」。
4. 點擊「檢測模型狀態」，選擇用途並「確認配置」，等待保存結果及用途標記。

自定義模型還需填寫 Provider 名稱、Base URL，並按實際端點選擇 OpenAI Chat Completions、Anthropic Messages 或 OpenAI Responses。模型列表出現條目不等於調用一定成功。

檢查與管理

「檢測模型狀態」展示本次檢測結果、模型、端點、響應時間或錯誤。保存後，在網頁對話發送簡短消息驗證。一次檢測成功不代表持續可用。

展開已配置服務商可以追加模型並保存。模型行可設為主模型、設置或取消備用，以及刪除模型；刪除服務商下最後一個模型時也會移除該服務商配置。步驟見模型切換。

常見問題

遇到 401 時核對 Key、端點、協議、地域和套餐類型；Coding Plan 與普通 API 的憑證可能不同。保存結果不明確時刷新核對，避免連續提交。對話仍失敗時檢查額度及診斷中心。