翻译文本

本页面介绍如何使用 Cloud Translation 基本版和高级版来翻译示例文本。

如基本文本翻译示例所示，Cloud Translation 基本版 API 提供了对标准神经机器翻译 (NMT) 模型的即插即用式直接访问权限。

另一方面，Cloud Translation 高级版则专为自定义和长篇内容用例进行了优化。如需查看示例代码，请参阅高级文本翻译示例。除了神经机器翻译 (NMT) 模型之外，高级版还可让您访问 Translation LLM（Google 最新的、最高质量的 LLM 类型翻译模型），并支持您针对特定用例创建自定义模型。

Cloud Translation 高级版还提供高级文本翻译功能（例如翻译文档和创建术语表），以确保正确翻译特定于您领域的术语。

准备工作

在开始使用 Cloud Translation API 之前，您必须具有启用了 Cloud Translation API 的项目，并且必须具有适当的凭据。您还可以安装常用编程语言的客户端库，以便调用 API。如需了解详情，请参阅设置页面。

高级文本翻译

在使用 Cloud Translation 高级版进行翻译时，输入内容可以是纯文本或 HTML。Cloud Translation API 不会翻译输入文本中的任何 HTML 标记，只会翻译出现在标记之间的文本。由于源语言和目标语言之间存在差异，输出会尽可能地保留（未翻译的）HTML 标记，并将翻译的文本置于标记之间。

高级文本翻译示例

REST

如需翻译文本，请发出 POST 请求，并在请求正文中提供 JSON 格式的文本，以标识要翻译的源语言 (source_language_code)、目标语言 (target_language_code) 以及要翻译的文本 (contents)。您可以提供多个要翻译的文本字符串，只需在 JSON 文本中加入这些字符串即可（请参阅示例）可以使用相应的 ISO-639 代码来标识源语言和目标语言。

下面显示了使用 curl 或 PowerShell 的 POST 请求的示例。该示例使用通过 Google CloudGoogle Cloud CLI 为项目设置的服务账号的访问令牌。如需了解有关安装 Google Cloud CLI、使用服务账号设置项目以及获取访问令牌的说明，请参阅设置页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_NUMBER_OR_ID：您的 Google Cloud 项目的数字或字母数字 ID

HTTP 方法和网址：

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText

请求 JSON 正文：

{
  "sourceLanguageCode": "en",
  "targetLanguageCode": "ru",
  "contents": ["Dr. Watson, come here!", "Bring me some coffee!"]
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

{
  "translations": [
    {
      "translatedText": "Доктор Ватсон, иди сюда!",
    },
    {
      "translatedText": "Принеси мне кофе!",
    }
  ]
}

translations 数组包含两个 translatedText 字段，其中译文以请求的 targetLanguageCode 语言（ru：俄语）提供。译文的排列顺序与相应源数组在请求中的顺序相同。

Go

试用此示例之前，请按照 Cloud Translation 快速入门：使用客户端库中的 Go 设置说明进行操作。 如需了解详情，请参阅 Cloud Translation Go API 参考文档。

如需向 Cloud Translation 进行身份验证，请设置应用默认凭证。 如需了解详情，请参阅为本地开发环境设置身份验证。 

// Imports the Google Cloud Translation library
import (
	"context"
	"fmt"
	"io"

	translate "cloud.google.com/go/translate/apiv3"
	"cloud.google.com/go/translate/apiv3/translatepb"
)

func translateText(w io.Writer, projectID string, sourceLang string, targetLang string, text string) error {
	// projectID := "your-project-id"
	// sourceLang := "en-US"
	// targetLang := "fr"
	// text := "Text you wish to translate"

	// Instantiates a client
	ctx := context.Background()
	client, err := translate.NewTranslationClient(ctx)
	if err != nil {
		return fmt.Errorf("NewTranslationClient: %w", err)
	}
	defer client.Close()

	// Construct request
	req := &translatepb.TranslateTextRequest{
		Parent:             fmt.Sprintf("projects/%s/locations/global", projectID),
		SourceLanguageCode: sourceLang,
		TargetLanguageCode: targetLang,
		MimeType:           "text/plain", // Mime types: "text/plain", "text/html"
		Contents:           []string{text},
	}

	resp, err := client.TranslateText(ctx, req)
	if err != nil {
		return fmt.Errorf("TranslateText: %w", err)
	}

	// Display the translation for each input text provided
	for _, translation := range resp.GetTranslations() {
		fmt.Fprintf(w, "Translated text: %v\n", translation.GetTranslatedText())
	}

	return nil
}

Java

试用此示例之前，请按照 Cloud Translation 快速入门：使用客户端库中的 Java 设置说明进行操作。 如需了解详情，请参阅 Cloud Translation Java API 参考文档。

如需向 Cloud Translation 进行身份验证，请设置应用默认凭证。 如需了解详情，请参阅为本地开发环境设置身份验证。 

// Imports the Google Cloud Translation library.
import com.google.cloud.translate.v3.LocationName;
import com.google.cloud.translate.v3.TranslateTextRequest;
import com.google.cloud.translate.v3.TranslateTextResponse;
import com.google.cloud.translate.v3.Translation;
import com.google.cloud.translate.v3.TranslationServiceClient;
import java.io.IOException;


public class TranslateText {

  // Set and pass variables to overloaded translateText() method for translation.
  public static