API 連線
Luker 本身不包含 AI 模型，它透過 API 連線到外部的大型語言模型（LLM）服務來產生回覆。本頁介紹如何設定和管理 API 連線。
支援的 API 類型
Luker 支援多種主流的 LLM API：
Chat Completion（聊天補全）
| API 供應商 | 說明 |
|---|---|
| OpenAI | GPT 系列模型（如 GPT-5 等） |
| Anthropic | Claude 系列模型 |
| Google AI Studio / Vertex AI | Gemini 系列模型 |
| OpenRouter | 聚合多家模型的中轉服務 |
| 自訂 OpenAI 相容 API | 任何相容 OpenAI API 格式的服務（如各類中轉站） |
Text Completion（文字補全）
| API 供應商 | 說明 |
|---|---|
| KoboldAI | 本機執行的開源模型 |
| Ollama | 本機模型管理和推理工具 |
| llama.cpp / TabbyAPI | 本機推理後端 |
| Text Generation WebUI | Oobabooga 的 Web 介面 |
INFO
Chat Completion 和 Text Completion 是兩種不同的 API 模式。大多數商業 API（OpenAI、Claude、Gemini）使用 Chat Completion 模式；本機模型通常兩種都支援。如果你不確定，Chat Completion 是更常用的選擇。
連線管理器
Luker 提供了連線管理器（Connection Manager）來管理多個 API 連線配置。
建立連線配置
- 開啟設定面板，找到連線管理器
- 點擊「新建配置」
- 填寫配置名稱（例如「Claude Sonnet 4.5」「GPT-5」）
- 選擇 API 類型並填寫連線參數
- 儲存配置
切換連線
在連線管理器的下拉清單中選擇不同的配置即可一鍵切換。切換連線不會影響你當前使用的聊天補全預設。
管理多個連線
你可以建立任意數量的連線配置，例如：
- 一個用於日常對話的低成本模型
- 一個用於高品質創作的旗艦模型
- 一個用於本機模型的配置
透過連線管理器可以在它們之間快速切換，無需每次都重新填寫 API 位址和金鑰。
API 金鑰配置
取得 API 金鑰
每個 API 供應商都有自己的金鑰取得方式：
- OpenAI：在 platform.openai.com 建立 API Key
- Anthropic：在 console.anthropic.com 建立 API Key
- Google：在 aistudio.google.com 取得 API Key
- OpenRouter：在 openrouter.ai 註冊並取得 Key
填寫金鑰
在連線配置中填入對應的 API 金鑰。金鑰會安全地儲存在 Luker 的伺服器端，不會在前端暴露。
TIP
如果你使用的是自行部署的 Luker 實例，API 金鑰儲存在你自己的伺服器上。如果使用他人提供的 Luker 實例，請注意金鑰安全。
模型選擇
設定好 API 連線後，你需要選擇要使用的具體模型。Luker 會根據 API 類型動態載入可用的模型清單。
對於 Claude 和 Gemini 等 API，Luker 支援動態模型清單——自動從 API 取得最新的可用模型，無需手動更新。你也可以為每個 API 來源自訂模型清單。詳見其他改進。
代理設定
如果你需要透過代理（Reverse Proxy）存取 API，可以在連線配置中設定：
- 代理位址：中轉服務的 URL
- 代理密碼：中轉服務的認證密碼（如果需要）
代理設定是連線配置的一部分，不同的連線配置可以使用不同的代理。
與預設解耦的關係
在 Luker 中，API 連線和聊天補全預設是完全獨立的兩個概念：
- 連線配置管理的是「用哪個 API、哪個模型、透過什麼位址存取」
- 聊天補全預設管理的是「用什麼提示詞、什麼取樣參數」
你可以自由組合它們。例如：
- 用同一個 Claude API 連線，搭配不同的預設來切換寫作風格
- 用同一套精心調教的預設，在 OpenAI 和 Claude 之間切換對比效果
這種解耦設計讓你可以獨立地優化連線和預設，互不干擾。
斜線命令
Luker 的連線管理器提供了斜線命令，方便進階使用者快速操作：
| 命令 | 說明 |
|---|---|
/profile [名稱] | 切換到指定連線配置，或查看當前配置名 |
/profile-list | 列出所有連線配置 |
/profile-create <名稱> | 用當前設定建立新配置 |
/profile-update | 更新當前選中的配置 |
請求檢查器
Luker 內建了請求檢查器（Request Inspector），可以查看每次產生請求的詳細資訊，包括傳送給 API 的完整請求內容和回傳的回應。這在除錯連線問題或優化提示詞時非常有用。