跳到內容

本頁由英文頁面機器翻譯而成。內容以英文頁面為準。 閱讀英文頁面

使用翻譯服務翻譯貼文

當讀者提出要求時,伺服器可以透過你設定的翻譯服務翻譯貼文:LibreTranslate、DeepL、Google Cloud Translation 或 Amazon Translate。伺服器擁有某個服務的金鑰時,該服務就會內建可用,再由實例設定 translation_providers 啟用它。

LibreTranslate 是開放原始碼的機器翻譯,你可以自行架設,也可以使用 libretranslate.com 的託管服務。用設定中的兩個項目讓伺服器指向它:

終端機視窗
MY_TRANSLATOR_LIBRETRANSLATE_URL=http://libretranslate:5000
# Only when the server asks for a key, as libretranslate.com does:
MY_TRANSLATOR_LIBRETRANSLATE_API_KEY=your-key
  • translator_libretranslate_url 是 LibreTranslate 伺服器的基礎 URL,使用 http: 或 https:,可以加上路徑。私有位址上的伺服器也能使用,例如與本伺服器並列的容器,或 http://10.0.0.5:5000。伺服器不會跟隨它回傳的重新導向,因此金鑰不會被送到其他地方。
  • translator_libretranslate_api_key 是機密資訊,只會從環境變數讀取(MY_TRANSLATOR_LIBRETRANSLATE_API_KEY 或 MY_TRANSLATOR_LIBRETRANSLATE_API_KEY_FILE)。對方伺服器不需要金鑰時請不要設定;自行架設的伺服器通常不需要。金鑰絕不會顯示給用戶端,也不會寫入日誌。

接著把 libretranslate 依你希望嘗試的順序加入實例設定 translation_providers,例如只設定 translation_providers = libretranslate,或在後面接上另一個服務的 ID 作為備援。

伺服器會在第一次翻譯前向 LibreTranslate 取得支援的語言清單,之後每小時更新一次,不會送出清單中沒有的語言組合的貼文。貼文沒有標示語言時,由 LibreTranslate 自動偵測。請在你架設的伺服器上安裝讀者所需的語言模型。

翻譯品質因語言而異。LibreTranslate 的模型對某些語言組合表現良好,對其他組合則較粗糙;從訓練資料較少的語言翻譯時,可能會誤解原意。啟用前請先試試你的社群使用的語言;如果需要,在 translation_providers 中把商用服務排在它後面。

文字會送到哪裡。由你自己架設的伺服器會把貼文文字留在你自己的機器上,不會有其他人收到。這時你可以用 translation_provider_visibilities 允許它處理 private 與 direct 貼文,例如 libretranslate=public|local|unlisted|private|direct,而隱私權政策中也不必列出任何外部翻譯服務。託管的 LibreTranslate(無論是 libretranslate.com 還是其他人架設的)會像其他服務一樣收到文字:請閱讀它的條款、保留預設的可見範圍,並在政策中寫明它。

DeepL 透過 DeepL API 方案的金鑰,經由其 API 進行翻譯。伺服器只會送出貼文的文字,以及代表提及、連結與裝飾的標記(以 XML 元素表示,DeepL 會保留其位置),不會送出貼文的其他內容。

  1. 從你的 DeepL 帳號取得驗證金鑰。免費方案的金鑰以 :fx 結尾。

  2. 在部署設定中設定它,然後重新啟動伺服器:

    終端機視窗
    MY_TRANSLATOR_DEEPL_API_KEY=your-key

    免費方案的金鑰會呼叫 https://api-free.deepl.com,其他金鑰則呼叫 https://api.deepl.com。若要經由代理伺服器,請設定 MY_TRANSLATOR_DEEPL_URL。金鑰是機密資訊:伺服器絕不會把它寫入日誌、放進錯誤訊息,或在設定與用戶端 API 的回應中顯示它,而且只會把它送到該位址,不跟隨重新導向。

  3. 用實例設定 translation_providers 啟用這個服務,可以單獨使用,也可以依你的順序排列:

    終端機視窗
    my instance set translation_providers deepl

伺服器第一次翻譯時會詢問 DeepL 支援哪些語言,之後每天再詢問一次。貼文的語言會對應到 DeepL 最接近的變體:英文對應 en-US、葡萄牙文對應 pt-BR、台灣中文對應 zh-Hant。DeepL 不支援的語言會交給下一個服務,或告知讀者無法翻譯。

額度。每個方案都有每月字元額度,付費方案還可以在你的 DeepL 帳號中設定費用上限。當 DeepL 回報額度用盡或達到速率限制時,伺服器會嘗試 translation_providers 中的下一個服務。若已沒有其他服務,讀者會看到這則貼文目前無法翻譯;如果你允許,Web 用戶端會改用瀏覽器的翻譯功能。伺服器自己的每月上限(translation_user_monthly_characters 與 translation_server_monthly_characters)會在任何呼叫之前生效,因此請把它們設得比 DeepL 額度低。DeepL 計算字元的方式可能與它們不同。

資料。啟用前請先閱讀 DeepL 的條款:

  • 在付費方案中,DeepL 只會在翻譯所需的期間保留文字與譯文;調查錯誤時最多保留 72 小時。
  • 在免費方案中,DeepL 可能永久保留文字與譯文,而且其條款禁止透過它傳送個人資料。貼文通常包含個人資料,因此免費方案只適合用來試用這個服務。絕對不要在 translation_provider_visibilities 中允許它處理 private 或 direct 貼文,並在你的隱私權政策中說明 DeepL 會保留它收到的內容。

在付費方案中,你可以逐一為各服務允許 private 與 direct 貼文:

終端機視窗
my instance set translation_provider_visibilities 'deepl=public|local|unlisted|private'

標示來源。DeepL 的條款要求每則譯文都要顯示其名稱或標誌。Web 用戶端會在每則來自 DeepL 的譯文旁顯示「DeepL」並連結到 https://www.deepl.com,所以你不需要另外加上任何東西。

Cloud Translation 的服務提供者 ID 是 google。伺服器會以一般翻譯模型呼叫它的 TranslateText 方法,並把文字以 HTML 送出,讓提及、連結和其他必須保持原樣的部分能原封不動地回來。

  1. 在負擔翻譯費用的專案中啟用 Cloud Translation API(translate.googleapis.com): gcloud services enable translate.googleapis.com --project PROJECT。
  2. 在該專案中授予伺服器的服務帳戶 roles/cloudtranslate.user: gcloud projects add-iam-policy-binding PROJECT --member serviceAccount:SA_EMAIL --role roles/cloudtranslate.user。
  3. 把 MY_TRANSLATOR_GOOGLE_PROJECT 設為專案 ID。MY_TRANSLATOR_GOOGLE_LOCATION 預設為 global;它 可以指定 Cloud Translation 中另一個提供一般模型的位置,例如 us-central1。
  4. 重新啟動伺服器,並把 google 加入實例設定 translation_providers。

在 Google Cloud 上使用 OpenTofu 模組 mycroblog-gcp 時, translation 區段會完成前三個步驟,而套用時會重新啟動服務:

translation = {} # or { project_id = "other-project", location = "us-central1" }

它會在部署所在的專案(或 project_id)中啟用 API,在那裡授予服務的服務帳戶 roles/cloudtranslate.user,並設定 translator_google_project 和 translator_google_location。然後把 google 加入 translation_providers。

伺服器以 Application Default Credentials 驗證身分,與它使用的其他 Google Cloud 服務相同:在 Cloud Run 上是服務的服務帳戶;在其他地方則是 GOOGLE_APPLICATION_CREDENTIALS 所指定的金鑰檔案。不使用 API 金鑰。伺服器在啟動時不會發出任何呼叫,所以缺少 API 或角色,要到讀者要求翻譯時才會顯示出來: 伺服器接著會嘗試下一個服務提供者,如果沒有剩下的,讀者會看到翻譯失敗。 Google 回報的專案配額或速率限制,同樣會轉到下一個服務提供者。

Google 依送出的字元數收費,每月有免費額度;請參閱 Cloud Translation 定價。伺服器自己的每月限制也會計算 字元數,但與 Google 的計費方式不完全相同,所以也請在 Cloud Billing 設定預算警示。

Google 聲明,它只會為了提供翻譯而使用這些文字, 只在記憶體中短暫保留,不會用來訓練它的模型,也不會分享。伺服器呼叫的是 Cloud Translation 的全域端點,Google 不會把處理限制在單一區域。

Google 的署名要求要求翻譯必須標示為 機器翻譯,並在旁邊顯示連結到 https://translate.google.com 的「powered by Google Translate」徽章。網頁用戶端會在這個服務提供者的每則 翻譯旁邊,顯示帶有該連結的「Google Translate」名稱。Google 只提供可下載的徽章圖片,所以伺服器不會向用戶端提供 這個服務提供者的標誌;請確認讀者看到的內容符合 Google 對你的實例的要求。

Amazon Translate 的服務提供者是 aws。伺服器會以 AWS SDK 預設鏈的憑證呼叫它的 TranslateText 操作, 與其他 AWS 服務相同:task 或執行個體的執行角色、環境變數 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY, 或共用憑證檔案。伺服器的設定中不會放任何金鑰。

  1. 為伺服器執行時使用的角色或使用者授予 IAM 權限 translate:TranslateText。對於語言 未知的貼文,Amazon Translate 會以 Amazon Comprehend 偵測語言;AWS 為 Amazon Translate 提供的受管政策會一併授予 comprehend:DetectDominantLanguage,所以也請授予它。
  2. 把 translator_aws_region(MY_TRANSLATOR_AWS_REGION)設為 Amazon Translate 的區域,例如 us-east-1。偵測 語言需要一個 Amazon Comprehend 也有運作的區域。
  3. 重新啟動伺服器,然後以 translation_providers = aws 啟用這個服務提供者,可以單獨使用,也可以放在其他服務提供者之間,依你偏好的順序 (實例設定)。

在 AWS 上使用 OpenTofu 模組 mycroblog-aws 時, translation 區段會完成前兩個步驟:translation = {} 會允許 task 的角色執行這兩個動作,並把 translator_aws_region 設為部署所在的區域,或你指定的 region。然後啟用服務提供者。

Amazon Translate 依送出的字元數收費,前 12 個月有免費方案 (定價)。伺服器只會送出貼文中的文字:提及、主題標籤、 連結和程式碼都留在伺服器上,每一個都會以 HTML 標記中的簡短預留位置送出。請把 translation_user_monthly_characters 和 translation_server_monthly_characters 的每月限制 控制在你願意支付的範圍內。

除非 AWS Organizations 的 AI 服務選擇退出政策 涵蓋該帳戶,否則 Amazon 可能會儲存這些文字並用來改善它的服務,也可能在另一個區域進行。 沒有選擇退出時,對於這些文字,Amazon 不只是你的服務提供者:請在你的 隱私權政策中說明(隱私權政策範本),並且不要在 translation_provider_visibilities 中 為 aws 允許 private 或 direct。預設情況下,服務提供者只會收到 public、 local 和 unlisted 的貼文。

供 LLM 與程式設計代理使用:llms.txt,llms-full.txt, llms-small.txt

本站的流量分析