翻译文字

借助 Vertex AI Translation 服务，您可以将以一种语言编写的文本翻译成任何其他受支持的语言 。

本页面介绍如何在 Google Distributed Cloud (GDC) 气隙设备上使用 Vertex AI Translation API 翻译示例文本。

准备工作

在开始使用 Vertex AI Translation API 之前，您必须有一个启用了 Vertex AI Translation API 的项目，并且必须具有适当的凭据。您还可以安装客户端库，以便调用 API。如需了解详情，请参阅 设置翻译项目。

翻译文字

translateText 方法会接受特定语言的输入文本，并返回翻译成另一种语言的文本。您可以输入纯文本或 HTML 文本作为输入。

如果您输入 HTML 文本，translateText 方法只会翻译 HTML 标记之间的文本，而不会翻译标记。不过，它会翻译 HTML5 标记中的属性，例如 alt 属性。在语法中，我们使用了一个使用 HTML5 标记和属性的示例，以将文本从翻译中排除。 输出会保留未翻译的 HTML 标记，并在标记之间包含翻译后的文本。

向 Vertex AI Translation 预训练 API 发出 curl 请求。否则，请通过 Python 脚本与 Vertex AI Translation 预训练 API 进行交互，以将文本从一种语言翻译成另一种语言。

以下示例展示了如何将输入文本从一种语言翻译成另一种语言：

curl

如需发出 curl 请求，请按以下步骤操作：

  1. 获取身份验证令牌。

  2. 发出请求：

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"parent": "projects/PROJECT_ID", "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": ["INPUT_TEXT"]}'

替换以下内容：

使用 mime_type 字段指定文件类型。将 mime_type 字段设置为以下某个值：

  • text/plain：您的输入是纯文本。
  • text/html：您的输入是 HTML 文本。

如果 mime_type 字段为空，则默认值为 text/html。

以下示例使用了 mime_type 字段：

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"mime_type": "text/html", "parent": "projects/PROJECT_ID", "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": ["INPUT_TEXT"]}'

输出会返回翻译后的文本。

Python

如需通过 Python 脚本使用 Vertex AI Translation 服务，请按以下步骤操作：

  1. 安装最新版本的 Vertex AI Translation 客户端库。

  2. 在 Python 脚本中设置所需的环境变量。

  3. 对 API 请求进行身份验证。

  4. 将以下代码添加到您创建的 Python 脚本：

    from google.cloud import translate
import google.auth
from google.auth.transport import requests
from google.api_core.client_options import ClientOptions

audience = "https://ENDPOINT:443"
api_endpoint="ENDPOINT:443"

def translate_client(creds):
  opts = ClientOptions(api_endpoint=api_endpoint)
  return translate.TranslationServiceClient(credentials=creds, client_options=opts)

def main():
  creds = None
  try:
    creds, project_id = google.auth.default()
    creds = creds.with_gdch_audience(audience)
    req = requests.Request()
    creds.refresh(req)
    print("Got token: ")
    print(creds.token)
  except Exception as e:
    print("Caught exception" + str(e))
    raise e
  return creds

def translate_func(creds):
  tc = translate_client(creds)
  req = {
    "parent": "projects/PROJECT_ID",
    "source_language_code": "SOURCE_LANGUAGE",
    "target_language_code": "TARGET_LANGUAGE",
    "mime_type": "text/plain",
    "contents": ["INPUT_TEXT"]
  }

  resp = tc.translate_text(req)
  print(resp)

if __name__=="__main__":
  creds = main()
  translate_func(creds)

    替换以下内容：

    使用 mime_type 字段指定文件类型。将 mime_type 字段设置为以下某个值：

    • text/plain：您的输入是纯文本。
    • text/html：您的输入是 HTML 文本。

    如果 mime_type 字段为空，则默认值为 text/html。

  5. 保存 Python 脚本。

  6. 运行 Python 脚本以翻译文本：

    python SCRIPT_NAME

    将 SCRIPT_NAME 替换为您为 Python 脚本指定的名称，例如 translation.py。

将文本从翻译中排除

在请求的 contents 字段中使用以下某个 HTML 标记，将文本的某些部分从翻译中排除：

  • <span translate="no">"TEXT"</span>
  • <span class="notranslate">"TEXT"</span>

将 TEXT 替换为您要从翻译中排除的文本部分。

例如，如果您有以下法语输入文本：

Bonjour, c'est un test.

然后，该文本在英语中翻译为以下句子：

Hello, this is a test.

假设您只想翻译文本的以下部分，而不包括输入文本中的 Bonjour,：

c'est un test.

文本的这一部分在英语中翻译为以下句子：

this is a test.

使用 HTML 标记将文本从翻译中排除。例如，以下 curl 请求使用 <span class="notranslate">"TEXT"</span> 标记在将文本翻译成英语时，将之前的法语输入文本中的 Bonjour, 从翻译中排除：

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"parent": "projects/PROJECT_ID", "source_language_code": "fr", "target_language_code": "en", "contents": ["<span class=\"notranslate\">\"Bonjour,\"</span>\"c'est un test.\""]}'

检测语言

detectLanguage 方法通过发送 HTTP 请求返回文本字符串的语言。

例如，以下请求会将输入文本 Hello, this is a test 中的语言检测为英语：

curl

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:detectLanguage -d '{"parent": "projects/PROJECT_ID", "content": "Hello, this is a test"}'

获取支持的语言

supportedLanguages 方法会返回 Vertex AI Translation API 支持的语言列表。

例如，以下请求通过指定 Vertex AI Translation 端点返回支持的语言：

curl

curl -vv -X GET -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID/locations/PROJECT_ID/supportedLanguages

如需查看支持的语言的完整列表，请参阅 Vertex AI Translation 支持的语言。