什么是 Azure 文本翻译？

Azure 翻译器是翻译服务的基于云的 REST API 功能。 它使用神经机器翻译技术，跨所有 支持的语言实时实现快速准确的源到目标文本翻译。 在本概述中，你将了解如何使用文本翻译 REST API 为应用程序和工作流构建智能解决方案。

文本翻译文档包含以下文章类型：

  • 快速入门。 入门指南，指导你如何向服务发出请求。
  • 操作指南。 有关以更具体或自定义的方式访问和使用服务的说明。
  • 参考文章。 REST API 文档和基于编程语言的内容。

文本翻译功能

最新的 GA 版本使用 API 版本 3.0。

  • 语言。 返回 Translate、 Transliterate 和 Dictionary Lookup 操作支持的语言列表。 此请求不需要身份验证。 将以下 GET 请求复制并粘贴到首选 REST API 工具或浏览器中：

    https://api.translator.azure.cn/languages?api-version=3.0

  • 翻译。 使用单个请求将单个源语言文本呈现为多个目标语言文本。

  • 音译。 将源语言的字符或字母转换为目标语言的对应字符或字母。

  • 检测。 返回源代码语言代码和布尔变量，该变量指示检测到的语言是否支持文本翻译和音译。

    Note

    可以使用单个 REST API 调用翻译、转译和检测文本。

  • 字典查找。 返回目标语言中源词的等效字词。

  • 字典示例。 返回源术语和目标术语对的语法结构和上下文示例。

文本翻译开发选项

使用以下资源将文本翻译添加到项目和应用程序：

发展选项 说明
REST API 使用 REST API （GA） 版本将翻译集成到应用程序中。
客户端库（SDK） 使用各种编程语言中的可用 客户端库（SDK） 将翻译功能集成到应用程序中。

Authentication

每个文本翻译请求都需要身份验证标头。 支持以下方法：

方法 说明
资源密钥 传递带有您 Translator 资源密钥的Ocp-Apim-Subscription-Key标头。
持有者令牌 将您的资源密钥兑换为时限令牌，然后通过令牌服务传递到 Authorization 标头中。
Microsoft Entra ID 使用托管身份或服务主体来获取访问令牌，而无需管理密钥。

有关详细信息和示例，包括区域终结点和自定义终结点所需的标头， 请参阅身份验证和授权。

服务限制和定价

文本翻译执行服务限制和配额，例如每次请求的字符限制。

疑难解答

如果请求失败，请从 HTTP 状态代码和服务特定的错误代码开始。

症状 可能的原因 解决方案
401 Unauthorized 订阅密钥无效或缺失。 验证该值 Ocp-Apim-Subscription-Key 是否与翻译器资源密钥匹配。
403 Forbidden 密钥有效，但资源无权执行所请求的操作。 确认定价层支持该功能，并且资源区域与终结点匹配。
429 Too Many Requests 超出请求速率限制或字符限制。 减少请求频率或查看服务限制中的配额 - 翻译器。
400 Bad Request 格式不正确的请求正文或不支持的语言代码。 验证 JSON 有效负载并检查 支持的语言。

文本翻译入门

按照以下步骤开始使用文本翻译：

  1. 在 Azure 门户中创建翻译器资源。

  2. 获取访问密钥和 API 端点。 需要终结点 URL 和只读密钥进行身份验证。

  3. 请浏览 文本翻译快速入门 ，以获取以下编程语言的用例和代码示例：

相关内容

  • Last updated on