模型配置
WiseMindAI 的 AI 功能需要先配置模型。有兩種方式：
- 在首次啟動 WiseMindAI 時，會引導你安裝本地模型
- 也可以接入自己已有的第三方模型 Key，比如 ChatGPT、DeepSeek、Gemini 等
打開 WiseMindAI 左下角「設定」，進入「模型設定」，就可以按使用場景配置不同模型。
後續所有的模型設定，都可以在這裡進行修改。
按需配置
- 本地模型：用於管理 Ollama、LM Studio 等本地模型服務。適合希望離線使用，或更重視資料隱私的場景。
- 通用模型：用於 AI 對話、文檔總結、知識庫總結、知識卡片、心智圖、外掛等主要功能。查看：大語言模型 Key。
- Embedding 模型：用於把文檔、網頁、筆記等內容轉成可檢索的知識索引，是知識庫問答的重要前置配置。查看：Embedding Key。
- OCR 文字辨識模型：用於從圖片、截圖、掃描資料中提取文字，方便後續總結和問答。查看：OCR 文字辨識服務 Key。
- 音視頻轉錄模型：用於從音訊、影片資料中提取文字，再進行總結、提綱整理和知識卡片生成。查看：音視頻轉錄服務 Key。
- 圖片生成模型：用於根據知識點或提示詞生成信息圖、海報等圖片內容。查看：圖片生成模型 Key。
- 即時轉錄模型：用於會議、課堂和訪談等正在進行的錄音，把麥克風聲音即時轉換成逐字稿。查看：即時轉錄。
音影片轉錄和即時轉錄是兩個獨立分類。前者處理已經存在的音訊或影片檔案，後者接收麥克風的連續聲音。部分平台會分別開通和計費，配置時請確認自己選擇了正確的服務。
直接測試線上模型
配置線上模型後，可以在目前模型卡片中直接點擊「測試」。測試會使用內建範例向服務商傳送一個最小請求，確認金鑰、模型名稱和服務位址是否可以正常使用。
目前支援直接測試：
| 模型分類 | 測試結果 |
|---|---|
| 通用模型 | 返回一段測試文字 |
| Embedding 模型 | 顯示生成的向量維度 |
| 圖片生成模型 | 顯示生成的測試圖片 |
| 圖片文字辨識 | 顯示從內建圖片中辨識出的文字 |
| 音訊模型 | 顯示內建音訊的轉寫結果 |
| 即時轉錄 | 顯示辨識文字、首段返回時間和總耗時 |
測試目前查看的模型時，不需要先把它設為正在使用。測試成功後，WiseMindAI 也不會自動切換模型或建立正式資料。
費用提示
線上測試會真實呼叫一次模型服務，可能產生少量費用。費用由模型服務商收取，本機模型不會顯示這套線上測試入口。
看懂測試失敗提示
如果測試沒有通過，可以根據頁面提示檢查：
- 配置不完整：還有必填項目沒有填寫。
- 身分驗證失敗：API Key、Secret Key 或其他驗證資訊不正確。
- 無法連線服務：網路異常，或者服務位址填寫錯誤。
- 模型不存在：模型名稱不正確，或目前帳號沒有使用權限。
- 額度不足或請求過快：需要儲值、等待額度恢復或稍後重試。
- 請求逾時：服務商暫時回應較慢，可以稍後再試。
- 沒有有效結果：服務已經返回，但沒有得到可用文字、圖片或向量。
如果模型測試正常，但具體功能仍無法使用，再檢查該功能是否選擇了同一個模型，以及目前資料是否滿足處理條件。
使用建議
如果你剛開始使用 WiseMindAI，可以先保留默認本地模型，再按需要補充一個通用模型 Key。這樣文檔總結、知識庫問答和知識卡片等核心功能會更穩定。
如果你已經有 OpenAI、Gemini、DeepSeek、智譜 AI、阿里雲百煉、OpenRouter 等平台的 Key，可以直接在對應服務商裡填寫；如果你使用的是 OpenAI 相容接口，可以選擇自訂 OpenAI 相容服務。
配置完成後，建議先測試再正式處理長文件、生成圖片或開始錄音。這樣可以提前發現金鑰、模型名稱、介面位址和帳號額度問題。
排查建議
如果文件總結可以使用，但文件對話或知識庫對話效果異常，優先檢查 Embedding 模型是否配置，並確認文件已經完成分析。
如果文件向量化失敗，可以查看錯誤提示和日誌。新版會記錄更多失敗資訊，方便判斷是模型配置、網路連線、文件格式還是內容過大導致的問題。
如果即時轉錄沒有收到文字，先分別使用麥克風檢測和即時轉錄模型測試。麥克風檢測用於確認裝置可以收到聲音，模型測試用於確認平台配置可以正常辨識，兩者需要分別通過。