API 金鑰
Transrewrt 本身不內建 AI — 它會將您的文字傳送至您選擇的 AI 供應商。要連接供應商，您需新增一個 API 金鑰：這是由供應商核發的私密代碼，作用如同該服務的密碼。您只需 一個 供應商即可開始使用，且無需付費：多家供應商提供免費模型或免費方案，您也可以完全不需要金鑰，直接在自己的電腦上執行模型。
支援的供應商包括 OpenRouter、OpenAI、Anthropic、Google Gemini、DeepSeek、Groq、Mistral、xAI、Cerebras、NVIDIA、Alibaba Cloud、apikey.fun、任何 OpenAI 相容端點，以及本地的 OpenAI 相容伺服器（Ollama、LM Studio、llama.cpp 等）。
步驟 1 — 選擇供應商
Section titled “步驟 1 — 選擇供應商”任何支援的供應商皆可使用。若您不確定該選哪一個：
- 免費開始：OpenRouter、Google Gemini、Groq、Mistral、Cerebras 與 NVIDIA 皆提供免費模型或免費方案。
- 已有帳號？ 若您已在使用 OpenAI、Anthropic 或其他支援的供應商，可直接沿用該帳號。
- 偏好將一切保留在自己的電腦上？ 完全跳過金鑰，改用本地模型。
步驟 2 — 建立 API 金鑰
Section titled “步驟 2 — 建立 API 金鑰”各供應商的確切步驟略有不同，但整體流程皆相同：
- 在供應商網站上註冊或登入。在 Transrewrt 的 設定 → API 設定 中，每個供應商都有一個 開啟供應商網站 連結，可直接帶您前往正確頁面。
- 找到 API 金鑰 頁面（有時位於帳號、儀表板或開發者設定底下）並建立新金鑰。部分供應商會要求您為金鑰命名或設定消費上限 — 兩者皆為選用。
- 複製金鑰。它是一長串字母與數字，通常以類似
sk-的內容開頭。
步驟 3 — 新增並測試金鑰（桌面版）
Section titled “步驟 3 — 新增並測試金鑰（桌面版）”- 在 Transrewrt 中，開啟 設定 → API 設定。
- 將金鑰貼上至您所使用供應商的欄位（例如 Google Gemini API 金鑰）並儲存。
- 點擊欄位旁的 測試 以確認金鑰可用。
測試成功後，您就準備好了 — 在主畫面上選擇該供應商並開始翻譯。
改用本地模型（無需 API 金鑰）
Section titled “改用本地模型（無需 API 金鑰）”您可以使用 Ollama、LM Studio、llama.cpp 或其他 OpenAI 相容伺服器（例如透過 LM Studio 的 google/gemma-4-e2b），在自己的電腦上執行模型。所有資料都不會離開您的機器，且無需 API 金鑰。
要連接此類模型，請將 Local LLM 基礎 URL 設為完整的 API 基礎位址（包含路徑）— 例如 http://localhost:11434/v1。在桌面版中，請於 設定 → API 設定 中設定；在 Docker 中，請改為設定 LOCAL_LLM_URL 環境變數。
Docker / 網頁版
Section titled “Docker / 網頁版”若您在瀏覽器中使用 Transrewrt，金鑰由執行伺服器的人員管理，而非在瀏覽器介面中輸入。管理員會在伺服器上將供應商金鑰設為 環境變數（例如 PROVIDER_API_KEY）— 請參閱設定。
首次執行檢查清單
Section titled “首次執行檢查清單”- 開啟應用程式，並視需要設定 介面語言。
- 新增並測試至少一個供應商金鑰 — 或設定本地模型（桌面版），或確認伺服器已設有環境變數金鑰（網頁版）。
- 在 簡易 模式下，於一般設定中選擇 供應商；在 進階 模式下，於 設定 → 模型 中新增模型 — 兩種模式的說明請見設定。
- 在 翻譯 頁面上，選擇預設設定或模型並執行簡短測試 — 請參閱翻譯文字。
- 金鑰測試失敗：檢查金鑰是否完整複製（前後沒有空格），以及是否已在供應商網站上被刪除或停用。
- 翻譯失敗並出現配額或額度錯誤：免費方案有每日或每月限制；請等待、切換至其他免費供應商，或增加額度。
- 簡易模式下未顯示供應商：開啟 設定 → API 設定 並確認至少已設定並測試一個金鑰（或本機 LLM URL）。
更多說明：常見問題。