Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

设置翻译项目

借助 Google Distributed Cloud (GDC) 网闸隔离设备中的 Vertex AI Translation，您可以在应用中将文本和文档翻译成支持的语言。创建项目并申请开发者角色后，在 GDC 控制台中启用 Vertex AI Translation API，以查看其状态和端点。然后，您可以安装 Python 客户端库、定义环境变量，并使用 gdcloud CLI 配置服务账号和对请求进行身份验证。如果您刚开始接触 Vertex AI，请参阅了解翻译功能。

创建项目

创建翻译项目可整理您的 Vertex AI Translation 资源，包括协作者、已启用的 API、身份验证凭证和访问权限控制。

如需创建项目，请参阅为 Vertex AI 设置项目。进行 API 调用时，您需要用到项目 ID。

请求开发者权限

您必须在项目中拥有 AI Translation Developer 角色，才能访问翻译服务并生成用于请求身份验证和授权的 API 令牌。

请让您的项目 IAM 管理员向您项目命名空间内的用户或服务账号授予 AI Translation Developer (ai-translation-developer) 角色。如需了解此角色，请参阅准备 IAM 权限。

启用 Vertex AI Translation API

您必须为项目启用 Vertex AI Translation 预训练 API。如果已启用，您可以查看 Vertex AI Translation 预训练 API 的服务状态和端点。

安装客户端库

客户端库支持 Python 编程语言。我们建议您使用这些客户端库来调用 Vertex AI Translation API，因为它们可以更轻松地访问 API。

安装 Vertex AI Translation 客户端库，并按照以下步骤操作，确保您使用的是正确的版本：

检查是否已安装 Vertex AI Translation 客户端库，并获取版本号：
```
pip freeze | grep translation
```
如果已安装客户端库，您将获得类似于以下示例的输出：
```
google-cloud-translation==3.8.0
```
您获取的版本号必须与以下端点处的客户端库匹配：
```
https://GDC_URL/.well-known/static/client-libraries
```
将 GDC_URL 替换为您的组织在 GDC 中的网址。
如果版本号不匹配，请卸载客户端库：
```
pip uninstall google-cloud-translation
```
如果您卸载了 Vertex AI Translation 客户端库，则必须通过指定与您的操作系统对应的文件名来重新安装。

设置环境变量

安装 Vertex AI Translation 客户端库后，您可以通过 Python 脚本与 API 进行交互。

如果您在项目中设置了服务账号，以便以编程方式进行授权 API 调用，则可以在 Python 脚本中定义环境变量，以便在运行时访问服务账号密钥等值。

请按照以下步骤在 Python 脚本中设置所需的环境变量：

创建 Python 脚本。
将以下代码添加到 Python 脚本中：
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
将 APPLICATION_DEFAULT_CREDENTIALS_FILENAME 替换为包含您在项目中创建的服务账号密钥的 JSON 文件的名称，例如 my-service-key.json。
将 Python 脚本保存为某个名称，例如 translation.py。
运行 Python 脚本以设置环境变量：
```
python SCRIPT_NAME
```
将 SCRIPT_NAME 替换为您为 Python 脚本指定的名称，例如 translation.py。

设置身份验证

您必须先对客户端凭据进行身份验证并请求对项目资源的账号访问权限，然后才能开始使用 Vertex AI Translation API。如需了解详情，请参阅对 API 请求进行身份验证。