Cloud Translation API 概览
Cloud Translation API 可以翻译 100 多种语言对的文本。如果您不知道源文本的语言，Cloud Translation API 可以为您检测该文本。如需查看所有支持的语言列表，请参阅支持的语言。
作为企业组织，您可以在现有内部工作流中添加译文。例如，您可能拥有全球支持团队，可接收使用不同语言的客户案例。您可以将 Cloud Translation API 添加到工作流中，以将这些客户案例翻译成支持团队成员所说的语言。使用 Cloud Translation API 可以提高支持团队的整体效率，因为他们不需要手动翻译文本，也不需要依赖其他人。
Cloud Translation API 可无缝扩缩，并且每天可允许不限数量的字符翻译。但是，每个请求和请求速率的内容大小存在限制。此外，您还可以使用配额限制来管理预算。如需了解详情，请参阅配额和限制。
Cloud Translation API 分为两个不同的版本，即基本版和高级版。如需查看每个版本支持的不同功能，请参阅版本比较。
Cloud Translation - Basic API
基本版可通过 v2 客户端库访问，并且只需进行最少的配置。它接受 API 密钥进行身份验证，也接受服务账号，并使用 Google 预训练的神经机器翻译 (NMT) 模型，无需进行任何修改。 它非常适合需要翻译用户生成的非正式内容（例如聊天、社交媒体或评论）的应用。
默认情况下，Cloud Translation API 使用基本版，Google 会在获得更多训练数据或有技术方面的改进时，按半定期节奏对其进行更新。
不过，如果您正在规划新项目，不妨选择高级版，以便利用更好的安全性、更多功能以及高级版未来将继续提供的全新服务改进。
Cloud Translation - 高级版 API
高级版通过 v3 客户端库进行访问，并且需要与 IAM 角色集成的服务账号身份验证。它提供了多种模型供您选择，包括翻译 LLM 模型、NMT 模型和 NMT 自定义。它还提供术语表、批量翻译、文档翻译等功能。
Cloud Translation 高级版 API 的主要功能包括：
使用更多模型 - 从先进的翻译模型中选择适合您的模型，例如 Translation LLM、Google 的神经机器翻译 (NMT) 模型、自适应翻译模型，或由您或其他人创建的自定义 NMT 模型。
术语表 - 创建自定义字典，以正确和一致的方式翻译特定领域的术语。
批量请求 - 发送异步请求以翻译大量文本。
文档翻译 - 翻译文档（例如 PDF 文件）以保留原始格式和布局。
IAM 角色 - 使用 Identity and Access Management 保护翻译请求。创建服务账号，并通过添加 IAM 角色授予这些权限。Cloud Translation 高级版 API 不支持 API 密钥。
标签 - 您可以向翻译请求添加用户定义的标签（键值对），以更好地跟踪使用情况并获取精细的结算报告。
区域端点 - 控制项目资源的存储和处理位置。
术语库
术语表是 Cloud Translation 高级版 API 的自定义字典，用于以正确和一致的方式翻译特定领域的术语、命名实体以及您的其他特定术语。例如，您可以使用术语库为“Google 编程之夏”“Gmail 机密模式”或“展示位置效果报告”等术语指定特定翻译。
您还可以使用术语表来防止某些字词（如借用字词或产品名称）被翻译。如需了解如何使用术语表，请参阅创建和使用术语表。
批量请求
批量翻译请求是指对来自 Cloud Storage 存储桶的输入进行翻译的异步请求。Cloud Translation 高级版 API 将批量翻译作为长时间运行的操作执行，并将输出写入到您指定的 Cloud Storage 存储桶。不支持批量翻译的内嵌请求。
如需了解如何发送批量请求，请参阅批量请求（高级版）。
文档翻译
Document Translation 可让您将现有的文档（如 PDF 和 DOCX 文件）直接翻译成目标语言。Document Translation 会保留原始格式，以使翻译后的文档与原始文档具有相同的布局和格式。例如，Document Translation 会保留段落分隔和标题，使已翻译的内容与原始文档中的内容一致。
Cloud Translation 高级版 API 功能（例如术语表和 AutoML 模型）也适用于文档翻译。例如，如果您有一个用于文本翻译的现有 AutoML 模型，则可以将同一模型用于文档翻译。如需详细了解支持的文件类型以及如何翻译文档，请参阅翻译文档。
模型选择和 AutoML 模型
借助 Cloud Translation 高级版 API 模型选择功能，您可以根据上下文和要翻译的内容，从 Translation LLM（您还可以进一步自定义该模型以实现自适应翻译）、Google 的 NMT 模型或自定义 AutoML Translation 模型中动态选择适合您应用的正确模型。
您可以使用 AutoML Translation 创建自定义模型，以针对特定领域的术语获取更准确的翻译。然后，您可以使用 Cloud Translation 高级版 API 中的最终模型翻译文本。
如需了解如何使用自定义模型翻译文本，请参阅翻译文本（高级版）。
IAM 角色
Cloud Translation 高级版 API 与 IAM 集成，可为您的翻译请求提供额外的安全保护，支持精细的访问权限控制，并且支持与 AutoML Translation 集成。
您必须将用户和服务账号添加至以下角色之一，才能向这些账号授予 Cloud Translation 高级版 API 的访问权限。如需了解如何创建服务账号，请参阅 IAM 文档中的创建和管理服务账号。
| 角色 | 角色 ID | 说明 |
|---|---|---|
| Cloud Translation API Viewer | roles/cloudtranslate.viewer |
可以使用 get 和 list 操作。 |
| Cloud Translation API User | roles/cloudtranslate.user |
包含 |
| Cloud Translation API Editor | roles/cloudtranslate.editor |
包含 |
| Cloud Translation API Admin | roles/cloudtranslate.admin |
包含 |
如需查看每个角色中包含的权限的列表，请参阅了解角色。
这些预配置的角色可以应对许多典型的使用场景。但是，您可能需要一个包含一组自定义权限的角色。例如，您可能希望创建一个角色，以允许用户在项目中创建术语表，但不允许用户删除或更新项目中的现有术语表。在这种情况下，您可以创建符合自己需求的 IAM 自定义角色。
如需了解如何管理 IAM 角色，请参阅授予、更改和撤消对资源的访问权限以及将角色授予服务账号。
标签
Cloud Translation 高级版 API 支持向 TranslateText、BatchTranslateText、DetectLanguage 请求添加用户定义的标签（键值对）。有关请求用量的信息会传递到结算系统，您可以在该系统中对您的标签进行过滤以细分结算费用。
如需详细了解用户定义的标签，请参阅通过标签报告用量（高级版）。
区域端点
默认情况下，Cloud Translation 高级版 API 会在全球位置存储和处理资源，这意味着无法保证资源保留在特定位置。您可以使用区域端点来将资源保存在特定位置（例如欧盟），而不是使用默认的全球端点。如需了解详情，请参阅指定区域端点。
版本比较
下表显示了每个版本中可用的功能。
| 特性 | 基本 | 高级 |
|---|---|---|
| 使用 NMT 模型进行翻译 | ||
| 使用翻译 LLM 进行翻译 | ||
| 使用自适应翻译模型进行翻译 | ||
| 使用自定义模型进行翻译 | ||
| 在单个请求中翻译多个字符串 | ||
| 使用 Cloud Storage 执行批量翻译 | ||
| 翻译文档 | ||
| 术语库支持（控制术语） | ||
| 训练自定义模型 | ||
| 语言检测 | ||
| 集成式 REST API | ||
| 集成式 gRPC API | ||
| 服务账号 | ||
| API 密钥 | ||
| 审核日志记录 | ||
| 支持 HTML | ||
| 支持 100 多种语言 | ||
| 拼音支持 | ||
| 音译支持 | ||
| 自适应翻译 | ||
| 多区域端点支持 | ||
| VPC Service Controls 支持 |
如需详细了解 Cloud Translation 高级版 API，请参阅 Cloud Translation 高级版 API 功能。
价格
Cloud Translation API 每月按您发送的字符数向您收取费用。如需了解详情，请参阅价格。
资源和补充阅读材料
- 如要开始使用该 API，请进行设置，然后按照快速入门指南操作。
- 比较支持的模型
- 自定义 NMT 模型
- 自定义 Translation LLM
- 支持的语言
- 支持的格式
- 执行自适应翻译
- 迁移到 Translation 高级版
- 如需 Cloud Translation API 的常见问题解答，请参阅常规常见问题解答页面。