準備工作
- 安裝並開啟 NoteGen。本文教學基於 NoteGen
0.38.2桌面版。 - 在 AIHubMix 控制台建立 API Key。
- 準備要使用的模型 ID，例如
gpt-5.6-terra。從模型列表複製模型 ID，可避免輸入錯誤。
設定 AIHubMix
1. 開啟模型服務
點擊 NoteGen 視窗右上角的設定按鈕，在設定側邊欄的 AI 群組中選擇 模型服務。
2. 選擇 AIHubMix 平台
在 模型平台 列表中點擊 AIHubMix。此平台由 NoteGen 內建，名稱旁顯示 贊助商 標誌。
3. 填寫連線設定
在 連線設定 分頁中填寫以下內容：- API 位址：已預設為
https://aihubmix.com/v1，保持不變。主地址暫時不可用時，改為備用地址https://api.inferera.com/v1。 - API Key：填入在 AIHubMix 控制台建立的 API Key。
- 網路代理：保持預設的 繼承全域代理。
API 位址 填寫到
/v1 為止，例如 https://aihubmix.com/v1。NoteGen 會依模型類型自動加上 /chat/completions、/embeddings 等 API 路徑。4. 新增對話模型
切換到 模型列表 分頁，點擊 添加模型。
- 模型：點擊 請選擇模型，在搜尋框中輸入模型 ID，例如
gpt-5.6-terra，然後選取該模型。列表中沒有該模型時，輸入完整模型 ID 後點擊 Use “模型 ID”。如果此處顯示的是文字方塊，直接填寫模型 ID，或點擊文字方塊右側的重新整理按鈕，重新取得模型列表。 - 模型類型：選擇 對話。新模型預設使用 對話。
5. 測試連線
點擊模型卡片右上角的 檢測連接。出現 AI 連接測試通過 提示時，表示 API Key、API 位址和模型 ID 均已生效。 如需新增更多模型，重複步驟 4和步驟 5。
使用 AIHubMix 模型
在 AI 對話中選擇模型
點擊右上角的關閉按鈕，返回主視窗。在視窗底部的狀態列中，點擊右側顯示的目前模型名稱，然後在 AIHubMix 群組下選擇剛才新增的模型。
在編輯器中使用 AI
編輯器未單獨指定模型時，編輯器的 AI 功能會使用所選的對話模型。在筆記中選取一段文字，點擊浮動工具列中的 AI 按鈕，然後選擇 潤色、精簡、擴展 或 翻譯。生成結果可以選擇接受或捨棄。 如需為編輯器單獨指定模型，前往 設置 → 編輯器設置，在 預設模型 區塊的 編輯器模型 中選擇。
設定知識庫模型（選用）
NoteGen 的知識庫使用嵌入模型進行語意檢索。重排模型為選用項目，用於改善檢索結果的排序。- 在 AIHubMix 平台的 模型列表 分頁中點擊 添加模型，填寫嵌入模型 ID，例如
text-embedding-3-small，將 模型類型 設為 嵌入，然後點擊 檢測連接。 - 如需使用重排序，再新增一個重排模型，例如
qwen3-reranker-0.6b，將 模型類型 設為 重排序，然後點擊 檢測連接。 - 開啟 設置 → 知識庫，在 檢索模型 中將 嵌入模型 設為剛才新增的嵌入模型。如果新增了重排模型，也將 重排模型 設為該模型。
常見問題
模型平台列表中沒有 AIHubMix 怎麼辦？ 檢查網路連線後，關閉設定視窗並重新開啟 模型服務，NoteGen 會重新取得平台列表。也可以點擊 模型平台 列表底部的 新增自訂平台，將平台名稱改為AIHubMix，API 位址 填寫 https://aihubmix.com/v1，再填入 API Key 並新增模型。
連線測試失敗怎麼辦？
檢查 API Key 是否完整、API 位址 是否為 https://aihubmix.com/v1、模型 ID 是否與 AIHubMix 模型列表一致，以及 模型類型 是否與模型能力相符。出現 401 或 403 錯誤時，檢查 API Key 和帳號權限；出現 404 錯誤時，檢查 API 位址和模型 ID。主地址暫時不可用時，將 API 位址 改為 https://api.inferera.com/v1。
底部的模型選擇器中找不到剛新增的模型怎麼辦？
模型選擇器只顯示 模型類型 為 對話 的模型。返回 設置 → 模型服務，確認該模型已填寫模型 ID，且 模型類型 為 對話。
對話輸入框顯示「未配置主模型，無法使用 AI 對話功能…」怎麼辦？
點擊視窗底部狀態列右側的模型名稱，然後在 AIHubMix 群組下選擇一個對話模型。
最後更新：2026-10-12