本頁由英文頁面機器翻譯而成。內容以英文頁面為準。 閱讀英文頁面
使用翻譯服務翻譯貼文
當讀者提出要求時,伺服器可以透過你設定的翻譯服務翻譯貼文:LibreTranslate、DeepL、Google Cloud Translation 或 Amazon Translate。伺服器擁有某個服務的金鑰時,該服務就會內建可用,再由實例設定 translation_providers 啟用它。
LibreTranslate
Section titled “LibreTranslate”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-keytranslator_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 會保留其位置),不會送出貼文的其他內容。
-
從你的 DeepL 帳號取得驗證金鑰。免費方案的金鑰以
:fx結尾。 -
在部署設定中設定它,然後重新啟動伺服器:
終端機視窗 MY_TRANSLATOR_DEEPL_API_KEY=your-key免費方案的金鑰會呼叫
https://api-free.deepl.com,其他金鑰則呼叫https://api.deepl.com。若要經由代理伺服器,請設定MY_TRANSLATOR_DEEPL_URL。金鑰是機密資訊:伺服器絕不會把它寫入日誌、放進錯誤訊息,或在設定與用戶端 API 的回應中顯示它,而且只會把它送到該位址,不跟隨重新導向。 -
用實例設定
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,所以你不需要另外加上任何東西。
Google Cloud Translation
Section titled “Google Cloud Translation”Cloud Translation 的服務提供者 ID 是 google。伺服器會以一般翻譯模型呼叫它的
TranslateText 方法,並把文字以 HTML 送出,讓提及、連結和其他必須保持原樣的部分能原封不動地回來。
- 在負擔翻譯費用的專案中啟用 Cloud Translation API(
translate.googleapis.com):gcloud services enable translate.googleapis.com --project PROJECT。 - 在該專案中授予伺服器的服務帳戶
roles/cloudtranslate.user:gcloud projects add-iam-policy-binding PROJECT --member serviceAccount:SA_EMAIL --role roles/cloudtranslate.user。 - 把
MY_TRANSLATOR_GOOGLE_PROJECT設為專案 ID。MY_TRANSLATOR_GOOGLE_LOCATION預設為global;它 可以指定 Cloud Translation 中另一個提供一般模型的位置,例如us-central1。 - 重新啟動伺服器,並把
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
Section titled “Amazon Translate”Amazon Translate 的服務提供者是 aws。伺服器會以 AWS SDK 預設鏈的憑證呼叫它的 TranslateText 操作,
與其他 AWS 服務相同:task 或執行個體的執行角色、環境變數 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY,
或共用憑證檔案。伺服器的設定中不會放任何金鑰。
- 為伺服器執行時使用的角色或使用者授予 IAM 權限
translate:TranslateText。對於語言 未知的貼文,Amazon Translate 會以 Amazon Comprehend 偵測語言;AWS 為 Amazon Translate 提供的受管政策會一併授予comprehend:DetectDominantLanguage,所以也請授予它。 - 把
translator_aws_region(MY_TRANSLATOR_AWS_REGION)設為 Amazon Translate 的區域,例如us-east-1。偵測 語言需要一個 Amazon Comprehend 也有運作的區域。 - 重新啟動伺服器,然後以
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