登入

翻譯模型配置說明

本教學用於說明精挑翻譯外掛程式中各類大模型的配置方式及相關參數意義，涵蓋 API Key、介面位址、模型選擇、效能參數與提示詞設定等內容。透過合理配置模型參數，可有效提升插件對大模型服務的穩定性，並在不同翻譯場景下改善翻譯準確性、反應效率與整體使用體驗。


1. 配置 API Key

API Key 是模型服務商提供的官方存取憑證，用於安全地呼叫其人工智慧模型與相關服務。

常見 API Key 配置問題

  • API Key 格式不正確：API Key 可能存在缺失字元、多餘空格或被錯誤截斷的情況。請確認完整複製官方提供的 Key，避免在前後包含空格、換行符或其他無效字元。
  • API Key 與模型服務商不符：不同模型服務商的 API Key 互不通用，例如 OpenAI 的 API Key 不可用於 DeepSeek 模型。
  • API Key 已失效或已停用：API Key 可能因過期、手動停用、帳號異常、額度上限或安全原因被撤銷。可前往服務商控制台確認 API Key 的狀態是否正常。
  • 介面位址配置錯誤：API Key 本身正確，但介面位址填入錯誤、缺少版本路徑，或與服務商要求的位址不一致，也會導致偵測失敗。
  • 模型名稱配置不正確：所填寫的模型名稱與服務商實際支援的模型不一致，或拼字錯誤，可能被誤認為 API Key 無效。
  • 網路或代理程式設定異常：本機網路、代理設定或防火牆限制可能會阻止請求正常傳送，表現為鑑權失敗或要求逾時。

2. 翻譯模型選擇

在配置插件時，模型名稱必須與 API Key 所屬服務商一致，否則將無法正常呼叫。

常見服務商與模型對應關係

服務商模型名稱
OpenAIgpt-5、gpt-5-mini、gpt-5-nano
Geminigemini-2.5-flash、gemini-2.0-flash-lite

💡 建議透過下拉式選單選擇模型名稱；如需手動輸入，請確保模型名稱與服務商特定的模型 ID（如 gpt-5、gpt-5-mini）一致。

3. 自訂 API 介面位址

插件預設配置了官方 API 位址，通常無需調整。若用於以下情況，才需手動填寫對應的介面位址：

  • 透過反向代理或中轉服務呼叫模型；
  • 使用私有化部署的大模型服務；
  • 接取未完全採用官方預設位址的第三方 API 服務。

填寫規範：

  • 位址必須為完整的 HTTPS 介面位址，例如：https://api.your-company.com/v1/chat/completions
  • 介面路徑需與對應服務商的技術文件保持一致，並確保此介面能夠正確接收並處理符合介面規格的請求格式。

4. 模型參數調整

以下參數用於調節翻譯的品質、模型穩定性和反應速度。 預設配置已覆蓋大多數使用場景，如有特殊需求，可根據實際情況進行調整。

參數說明推荐设置
每次請求的最大文字長度用於限制單次翻譯請求中可提交的最大字元數。設定過大可能導致介面反應變慢，合理控制該值有助於提升翻譯的穩定性與反應速度。- 推薦 1000–1500 字符
- 避免超過 2000 字符，以防響應延遲或內容遺失。
每次請求的最大段落數單次翻譯請求中可同時提交的段落數量。段落數量過多可能增加請求處理負載，導致介面回應變慢或穩定性下降；合理設定有助於提升整體翻譯效率與穩定性。- 技術文件/法律文本：1（逐段處理，確保術語準確）
- 小說/對話/部落格：3–5（提升流暢度）
每秒最大請求數每秒發起的翻譯請求次數。當請求頻率過高時，新增請求將進入佇列等待，以避免觸發介面限流並提升整體運作穩定性。- 通用使用：25
- 限流嚴格服務（如 Gemini）：8–10
溫度用於控制模型輸出的隨機性與發散程度。較高的溫度值會產生更多樣化、更靈活的表達；較低的溫度值則使輸出更加穩定，更適合追求一致性和準確性的翻譯需求。- 翻譯任務推薦：每個模型的官方建議溫度不一致，建議使用提供的預設溫度；可依需求調整

💡 建議調整參數後，透過相同的原文進行對比測試，以便更準確地評估調整後對翻譯效果的影響。

5. 自訂提示詞（System Prompt/User Prompt）

插件內建經過最佳化的通用翻譯提示詞，能夠滿足大多數常見翻譯場景的需求。 當有特定要求時（例如譯文風格、術語一致性、專業領域或語氣偏好），可透過自訂提示詞對模型的輸出結果進行精細化控制。

在編寫自訂翻譯提示詞時，建議遵循以下原則：

  • 提示內容清晰明確：明確指定目標語言、翻譯風格、所屬領域，以及需要避免的表達方式或用詞傾向。
  • 指令具備可執行性：使用具體、明確的描述，避免含糊或抽象的表述，確保模型能夠準確理解並執行指令。
  • 合理控制提示長度：提示詞應在資訊充分的前提下保持簡潔，避免冗餘描述對模型理解造成乾擾。

💡 如有疑問或建議，建議參考服務商官方文件或前往 問題回饋 頁面提交回饋。

6. 免責聲明

⚠️ 【使用自訂 API Key】模式所產生的費用將由對應服務商根據實際使用情況進行結算。本擴充僅負責提供呼叫能力，不會向您收取任何額外費用。

🔔 請注意相關服務商提供的免費額度和所產生的費用，避免額外扣費。

翻譯額度 (TQ) 與模型 Token 的換算

模型配置流程