Cloud Translation API 總覽
Cloud Translation API 可翻譯超過 100 種語言組合的文字。如果您不知道原文語言，Cloud Translation API 可為您偵測。如需所有支援語言的清單，請參閱「支援的語言」。
企業組織可以在現有的內部工作流程中加入譯文。舉例來說，您可能有一支全球支援團隊，會收到多種語言的客服案件。您可以在工作流程中加入 Cloud Translation API，將這些客服案件翻譯成支援團隊成員使用的語言。有了 Cloud Translation API，支援團隊就無須手動翻譯文字或仰賴他人，整體效率將有所提升。
Cloud Translation API 可靈活調整，且每日翻譯字元總數無上限。不過，每項要求的內容大小和要求比率都設有限制。此外，您也可以使用配額限制來管理預算。詳情請參閱「配額與限制」一文。
Cloud Translation API 版本和模型
Cloud Translation API 有兩種版本，分別是基本版和進階版。如要查看各版本支援的功能清單，請參閱版本比較。
並提供多種模型供您選擇，以便挑選適合特定應用程式的模型。
Cloud Translation - Basic API
您可透過 v2 用戶端程式庫存取 Basic 版，且只需進行最少的設定，即可接受 API 金鑰進行驗證，以及服務帳戶。只能存取未經修改的 Google 神經機器翻譯 (NMT) 模型。適合用來翻譯使用者建立的一般內容，例如聊天訊息、社群媒體貼文或留言。
如果您正在規劃新專案，建議選擇 Advanced 版，而非 Basic 版，才能享有更完善的安全性、更多功能，以及 Advanced 版未來將持續提供的服務改善項目。
Cloud Translation - Advanced API
您可透過 v3 用戶端程式庫存取 Advanced 版本，並需要與 IAM 角色整合的服務帳戶驗證。提供多種模型，包括最新的翻譯 LLM (TLLM) 模型，以及有/無自訂功能的 NMT 模型。此外，這項服務也提供詞彙表、批次翻譯、文件翻譯等功能：
詞彙表：詞彙表是您建立的自訂字典，可正確且一致地翻譯特定領域的詞彙。
批次要求：批次要求可讓您提出非同步要求，翻譯大量文字。
Document Translation：這項功能可翻譯 PDF 檔案等文件，同時保留原始格式和版面配置。
IAM 角色：透過 Identity and Access Management，確保翻譯要求安全無虞。您可以建立服務帳戶，並使用 IAM 角色授予權限。請注意，Cloud Translation - Advanced API 不支援 API 金鑰。
標籤：在翻譯要求中新增使用者定義的標籤 (鍵/值組合)，以便追蹤用量及產生精細的帳單報表。
區域端點：使用區域端點，即可控管專案資源的儲存和處理位置。
進階 API 功能
使用 Cloud Translation - Advanced API 而非 Cloud Translation - Basic API，可存取下列功能，讓翻譯解決方案更強大，且更適合特定用途：
模型選取和自訂
Cloud Translation - Advanced API 模型選取功能可讓您動態選取不同模型，包括您為特定應用程式自訂的模型。
詞彙表
詞彙表是一種自訂字典，可用來協助 Cloud Translation - Advanced API 正確且一致地翻譯特定領域的詞彙、具名實體，以及其他特定詞彙。例如，您可以使用詞彙表指定詞彙的特定翻譯，例如「Google Summer of Code」、「Gmail 機密模式」或「刊登位置成效報表」。
您也可以使用詞彙表，避免翻譯借用字詞或產品名稱等特定字詞。如要瞭解如何使用詞彙表，請參閱「建立及使用詞彙表」一文。
批次要求
批次翻譯要求為非同步要求，可翻譯 Cloud Storage bucket 的輸入內容。Cloud Translation - Advanced API 會以長時間執行的作業執行批次翻譯，並將輸出內容寫入您指定的 Cloud Storage bucket。但不支援批次翻譯的內嵌要求。
文件翻譯
透過 Document Translation，您可以直接將現有文件 (例如 PDF 和 DOCX 檔案) 翻譯成譯文語言。Document Translation 會保留原始格式，讓翻譯文件的版面配置和格式與原始文件一致。舉例來說，Document Translation 會保留分行和標題，讓翻譯內容的劃分方式與原始文件相同。
詞彙表和自訂 NMT 模型等 Cloud Translation - Advanced API 功能也適用於 Document Translation。舉例來說，如果您有現成的自訂 NMT 模型用於翻譯文字，就可以將該模型用於 Document Translation。如要進一步瞭解支援的檔案類型和如何翻譯文件，請參閱「翻譯文件」一文。
IAM 角色
Cloud Translation - Advanced API 會與 IAM 整合，為翻譯要求提供額外的安全措施、啟用精密的存取控管，並支援與自訂 NMT 模型整合。
您必須將使用者和服務帳戶新增至下列其中一個角色，才能授予這些帳戶 Cloud Translation - Advanced API 的存取權。想瞭解如何建立服務帳戶，請參閱 IAM 說明文件中的「建立及管理服務帳戶」一文。
| 角色 | 角色 ID | 說明 |
|---|---|---|
| Cloud Translation API 檢視者 | roles/cloudtranslate.viewer |
可存取 get 與 list 作業。 |
| Cloud Translation API 使用者 | roles/cloudtranslate.user |
包含 |
| Cloud Translation API 編輯者 | roles/cloudtranslate.editor |
包含 |
| Cloud Translation API 管理員 | roles/cloudtranslate.admin |
包含 |
如要查看每個角色包含的權限清單，請參閱這篇文章。
這些預先設定的角色可因應許多一般用途，不過，您可能需要包含一組自訂權限的角色。舉例來說，您可能想要建立一個角色，允許使用者在專案中建立詞彙表，但不允許他們刪除或更新專案中的現有詞彙表。在這種情況下，您可以建立符合需求的 IAM 自訂角色。
想瞭解如何管理身分與存取權管理角色，請參閱「授予、變更及撤銷資源的存取權」和「將角色授予服務帳戶」這兩篇文章。
標籤
Cloud Translation - Advanced API 支援在 TranslateText、BatchTranslateText 和 DetectLanguage 要求中加入使用者定義的標籤 (鍵/值組合)。系統會將要求的用量資訊轉送至帳單系統，方便您依據標籤篩選條件查看帳單費用明細。
如要進一步瞭解使用者定義的標籤，請參閱「使用標籤產生用量報表 (Advanced)」。
區域端點
根據預設，Cloud Translation - Advanced API 會在全球位置儲存及處理資源，因此無法保證資源會保留在特定位置。您可以改用區域端點，將資源保留在特定位置 (例如歐盟)，而不使用預設的全域端點。詳情請參閱「指定地區端點」一文。
版本比較
下表列出各版本支援的功能。
| 功能 | Basic | Advanced |
|---|---|---|
| 使用 NMT 模型翻譯 | ||
| 使用翻譯 LLM 翻譯 | ||
| 使用 Adaptive Translation 模型翻譯 | ||
| 使用自訂模型翻譯 | ||
| 在單一要求中翻譯多個字串 | ||
| 使用 Cloud Storage 進行批次翻譯 | ||
| 翻譯文件 | ||
| 詞彙表支援 (控制項術語) | ||
| 訓練自訂模型 | ||
| 語言偵測 | ||
| 整合 REST API | ||
| 整合式 gRPC API | ||
| 服務帳戶 | ||
| API 金鑰 | ||
| 稽核記錄 | ||
| 支援 HTML | ||
| 支援 100 多種語言 | ||
| 羅馬拼音支援 | ||
| 音譯支援 | ||
| Adaptive Translation | ||
| 多區域端點支援 | ||
| VPC Service Controls 支援 |
如要進一步瞭解 Cloud Translation - Advanced API，請參閱這篇文章。
定價
系統會依據您傳送的字元數，按月收取 Cloud Translation API 費用。詳情請參閱這篇文章，瞭解定價相關資訊。
資源與延伸閱讀
- 如要開始使用 API，請先完成設定，然後參閱快速入門指南。
- 比較支援的模型
- 自訂 NMT 模型
- 自訂 Translation LLM
- 支援的語言
- 支援的格式
- 進行 Adaptive Translation
- 遷移至 Translation Advanced
- 如需 Cloud Translation API 的一般問題解答，請參閱「一般常見問題」頁面。