相較於許多將創作者鎖定在單一閉源模型、並在月費中捆綁高額 Token 溢價的 AI 寫作工具，Novelcrafter 採取了**自備金鑰（BYOK, Bring Your Own Key）**的架構體系。Novelcrafter 專注於提供長篇小說創作所需的專業鷹架——包含無干擾的手稿編輯器、場景節拍（Scene Beats）大綱管理，以及結構化的世界觀設定集（Codex）；而底層生成內文的 AI 算力則完全交由作者自主決定。小說家可以直接串接主流商業大模型、聚合服務平台，甚至是完全離線運行的本機開源模型。
若要充分發揮這套系統的效益，小說作者需要完成三項核心配置：串接 API 憑證、在提示詞預設中掛載所需模型，並針對虛構故事的語感調校生成採樣參數（例如 Temperature、Top P 與各類重複懲罰機制）。
一、串接外部 AI 服務商與 API 金鑰
在 Novelcrafter 中，AI 連線屬於帳戶層級的設定。點擊介面左下角或右上角的個人頭像 → Open Settings → AI Credentials（或 AI Connections）即可開啟管理面板。特別需要留意的是：所有 API 金鑰均儲存在當前瀏覽器的本機儲存空間（Local Storage）中，不會同步至雲端資料庫。若清除瀏覽器快取、使用無痕私密視窗，或在不同電腦裝置間切換，皆需重新授權或透過匯出/匯入功能轉移連線設定。
1. OpenRouter 串接（推薦多數創作者首選）
對於希望以單一帳戶調用多家頂尖模型的寫作者，OpenRouter 是最便捷的整合途徑：
- 在 AI Credentials 清單中找到 OpenRouter，點擊 Connect。
- 選擇 Continue to OpenRouter，登入或註冊帳戶並完成授權。
- 授權時可自由設定該金鑰的消費額度上限（Credit Limit）。請注意：若設定了額度上限且後續觸發該上限，Novelcrafter 將會回傳金鑰無效或額度不足的錯誤訊息；此時必須至 OpenRouter 後台手動調高或取消該項限制。
- 串接完成後，只需在 OpenRouter 帳戶預先儲值，即可同時調用 Anthropic Claude 系列、OpenAI GPT、Mistral、Llama 等數十種熱門雲端模型。
2. OpenAI 官方 API 直連
若擁有 OpenAI 開發者平台帳戶：
- 登入 OpenAI 開發者後台生成並複製 API 密鑰。注意：一般個人的 ChatGPT Plus 訂閱與開發者 API 屬於獨立系統，無法直接以 Plus 帳號存取 API 介面。
- 在 Novelcrafter 的 AI Credentials 介面選擇 OpenAI，貼上金鑰並儲存。
3. OpenAI 相容介面（自訂雲端服務與本機離線模型）
Novelcrafter 支援透過標準 OpenAI API 協定串接其他第三方供應商與本機私有模型：
- 捲動至 AI Credentials 底端，點擊 OpenAI Compatible Connection → Add。
- 輸入自訂服務名稱（例如 Fireworks、Grok / xAI、Groq、Mancer、NanoGPT 或 NovitaAI）以及對應的 Base URL。絕大多數相容介面的網址以
/v1結尾（例如https://api.groq.com/openai/v1或https://api.x.ai/v1）。 - 貼上 API 金鑰後，Novelcrafter 通常會自動探測該端點支援的模型清單。若未能自動辨識，可勾選 Use custom model list，手動輸入模型代碼（以逗號或換行分隔，名稱須與服務商完全一致）。
- 本機完全離線寫作：若作者透過 LM Studio 或 Ollama 於本機電腦運作大模型，可在 Base URL 填入本機服務位址（例如
http://localhost:1234/v1）。這不僅能保障作品完全不外洩，也無需承擔任何 Token 傳輸費用。 - 關於 Anthropic 官方控制台的限制：受限於現代瀏覽器的跨來源資源共享（CORS）安全機制，前端網頁無法直接從瀏覽器端呼叫 Anthropic 的官方 API。欲使用 Claude 模型的作者，建議透過 OpenRouter 串接，或自行搭建 LiteLLM 本地中繼轉發。
二、在提示詞庫（Prompts）中配置與管理模型
當 API 憑證設定就緒後，模型並非全域共用單一預設，而是依任務分配給不同的提示詞動作。Novelcrafter 將長篇小說的寫作輔助拆分為獨立功能：場景節拍內文生成（Scene Beat Completion）、順接續寫（Continue Writing）、場景自動摘要（Scene Summarization）與靈感對話助理（Workshop Chat）。
若要調整特定寫作任務所調用的模型：
- 從專案左側側邊欄或主選單中開啟 Prompt Library（提示詞庫）。
- 選擇欲設定的提示詞（例如系統內建的 General Purpose Scene Beat Completion）。
- 若為系統唯讀預設，請先點擊 Clone（複製克隆）產出自訂副本，因為官方內建預設不支援直接修改參數。
- 進入提示詞編輯畫面的 General 標籤頁，切換至 Models。
- 此處可自由新增、移除模型，或連結預先建立的 Model Collections（模型集合）。建議依創作場景分類整理，例如將「快速腦暴集合」（如 Groq Llama 3）與「精緻文筆集合」（如 Claude 3.5 Sonnet）分開，方便撰寫時隨時切換。
三、調校內文生成採樣參數（Prose Settings）
在小說創作中，模型參數的微調直接決定了文字的風格張力、修辭多樣性與邏輯連貫度。在提示詞的 Models 列表中，點擊各模型名稱右側的開展圖示（>），即可調整核心採樣參數：
1. Temperature（採樣溫度：創意與遵循的取捨）
- 運作機制：控制模型預測下一個 Token 時的機率分佈平滑程度。
- 調低數值（0.3 – 0.6）：文字更為專注、精準且遵循指令。適合用於梳理情節摘要、維持角色一致的特殊口吻，或推進需要精確埋藏伏筆的關鍵橋段。
- 調高數值（0.7 – 1.0+）：文字展現更高的冒險性與想像力，修辭更為生動豐富。適合在感覺文句平淡重複、或者需要撰寫細膩感官描寫、超現實夢境或史詩戰鬥時使用。
2. Top P（核採樣：詞彙邊界與異常詞過濾）
- 運作機制：將候選詞限制在累積機率達到特定百分比的最高機率詞群中。
- 創作實務：當模型在高 Temperature 下出現語義錯亂、拼造生僻怪詞或符號亂碼時，調低 Top P（例如降至 0.85 – 0.90）是最有效的修正手段，能將詞彙鎖定在較穩妥的範圍內；若希望文字詞藻更具多樣性，則可適度調高。
3. Max Tokens（最大長度與篇幅控制）
- 運作機制：設定單次輸出的 Token 數量上限。
- 創作實務：語言模型一旦達到 Max Tokens 限制，會立刻在當前位置中斷輸出，即使語句尚未完整。因此，切勿以過低的 Max Tokens 來限制段落長度；建議將上限設置為足以涵蓋一個完整節拍的空間（例如 800 至 1,500 Tokens），並透過提示詞內容或輸入變數來指定目標字數。
4. 懲罰參數（Penalties：杜絕重複與車輪語句）
- Frequency Penalty（頻率懲罰）：根據詞彙在當前輸出中出現的頻次施加抑制。若發現模型頻繁濫用特定口頭禪或轉折詞（例如「突然間」、「凝視著」、「倒吸一口氣」），可微調增加（+0.1 至 +0.3）；請避免數值過高，否則可能導致模型避開角色的名字。
- Presence Penalty（存在懲罰）：只要主題或概念曾出現過即受抑制。適合用於角色交鋒對話或動態轉折，引導模型引入新話題，避免在同一爭端上原地打轉。
- Repetition Penalty（通用重複懲罰）：開源與本地模型常見的通用參數（通常介於 1.05 至 1.15），能有效阻絕長句死循環。
- Reasoning / Thinking Effort（思考推理深度）：針對支援深度思維鏈的模型（如 Claude 思考模式或 OpenAI 推理系列），調整此參數能讓模型在著手撰寫內文前，先在幕後比對大綱走向與 Codex 世界觀設定的合理性。
四、在 Write 手稿編輯器中實戰應用
當憑證與提示詞預設配置完畢後，在日常撰寫手稿時調用模型非常流暢：
- 進入手稿的 Write 介面，選取任何章節或場景。
- 於內文任意空白行輸入斜線指令
/，從彈出選單中點選 Scene Beat。 - 輸入本段故事發生的情節指令（如角色動作、情緒起伏）。Novelcrafter 會自動偵測並標註你提及的 Codex 詞條（角色、地點、專有名詞）。
- 在右方 Play（▶） 鍵旁的下拉選單中，選取你調校好的模型預設，或點擊 Tweak and Generate 臨時調整傳入變數。
- 生成完成後，Novelcrafter 提供四種後續處理途徑：
- Apply：直接採納生成內容並嵌入內文。
- Retry：捨棄本次輸出，以相同參數重新生成一次。
- Discard：直接清除本次生成結果。
- Section：將輸出包裝為可收合的區塊（Section）。作者可使用不同模型分別生成多個版本，再以「零件拼裝（Kitbashing）」的方式摘取各版本精華結合成最終文稿。
透過本機安全的 BYOK 串接、模組化的提示詞庫以及精準的生成參數校準，小說作者既能透明掌控每一分 AI 支出，又能隨心所欲地打造專屬於故事的獨特敘事質感。