你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

创建“翻译”资源

在本文中,你将了解如何在 Azure 门户中创建翻译器资源。 Azure AI 翻译是一项基于云的机器翻译服务,是 Azure AI 服务系列的一部分。 Azure 资源是你创建的服务实例。 对 Azure AI 服务的所有 API 请求都需要一个终结点 URL 和一个只读密钥,用于进行访问身份验证。

先决条件

若要开始,你需要一个有效的 Azure 帐户。 如果没有帐户,可以创建有效期为 12 个月的免费订阅

创建资源

使用 Azure 帐户,可以通过两种不同的资源类型访问翻译服务:

  1. 单服务资源类型允许访问单服务 API 密钥和终结点。

  2. 通过多服务资源类型,可使用单个 API 密钥和终结点访问多个 Azure AI 服务

完成项目和实例详细信息

确定要用于访问翻译服务的资源类型后,可以输入项目和实例的详细信息。

  1. 订阅。 选择一个可用的 Azure 订阅。

  2. 资源组。 可以创建新资源组,或将资源添加到共享相同生命周期、权限和策略的预先存在的资源组。

  3. 资源区域。 选择“全球”,除非你的业务或应用程序需要特定区域。 如果计划配合使用文档翻译功能与托管标识授权,请选择一个地理区域,例如“美国东部”。

  4. 名称. 输入资源的名称。 所选名称在 Azure 中必须唯一。

    注意

    如果你使用的是需要自定义域终结点的翻译功能(例如文档翻译),则你在“名称”字段中输入的值将是该终结点的自定义域名参数。

  5. 定价层。 选择满足你需求的定价层

    • 每个订阅都有一个免费层。
    • 免费层具有与付费计划相同的特性和功能,并且不会过期。
    • 每个订阅仅提供一个免费层资源。
    • 仅付费层支持文档翻译。 Language Studio 支持 S1 和 D3 实例层。 如果只是要试用文档翻译,请选择“标准 S1 实例层”。
  6. 如果创建多服务资源,“基本信息”选项卡底部的链接提供了有关服务适当操作的技术文档。

  7. 选择“查看 + 创建” 。

  8. 查看服务条款,然后选择“创建”以部署资源

  9. 成功部署资源后,选择“转到资源”。

    身份验证密钥和终结点 URL

    所有 Azure AI 服务 API 请求都需要终结点 URL 和只读密钥来进行身份验证。

    • 身份验证密钥。 密钥是在每次请求翻译服务时传递的唯一字符串。 可以通过查询字符串参数传递密钥,或在 HTTP 请求标头中指定密钥。

    • 终结点 URL。 请在 API 请求中使用“全球”终结点,除非你需要特定的 Azure 区域或自定义终结点。 有关详细信息,请参阅基 URL。 “全球”终结点 URL 为 api.cognitive.microsofttranslator.com

获取身份验证密钥和终结点

若要对翻译器资源的连接进行身份验证,需要查找其密钥和终结点。

  1. 部署新资源后,选择“转到资源”或直接转到资源页

  2. 在左侧导航窗格中的“资源管理”下,选择“密钥和终结点”

  3. 将密钥和终结点 URL 复制并粘贴到一个方便的位置(例如记事本)。

    Azure 门户的屏幕截图,其中显示了翻译器资源的“密钥和终结点”页面。突出显示了密钥和终结点。

创建文本翻译客户端

文本翻译支持全局终结点和区域终结点。 获得身份验证密钥后,需要创建 TextTranslationClient 的实例,使用 AzureKeyCredential 进行身份验证,以便与文本翻译服务进行交互:

  1. 若要使用全局资源终结点创建 TextTranslationClient,需要资源 API 密钥

      AzureKeyCredential credential = new('<apiKey>');
      TextTranslationClient client = new(credential);
    
  2. 若要使用区域资源终结点创建 TextTranslationClient,需要资源 API 密钥和资源所在的区域的名称:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential, '<region>');
    

创建文档翻译客户端

使用文档翻译 API 跨语言异步翻译大量文本和多个文档。 批量翻译过程需要一个 Azure Blob 存储帐户,其中包含源文档和翻译文档的存储容器。

  1. 目前,在使用 S1 标准服务计划(即用即付)或 D3 批量折扣计划的翻译器(单服务)资源中支持文档翻译。

  2. “有关为文档翻译创建翻译器资源的详细信息,请参阅先决条件:使用文档翻译

如何删除资源或资源组

警告

删除资源组会删除组中包含的所有资源。

若要删除资源,请执行以下操作:

  1. 在 Azure 门户中搜索并选择“资源组”,然后选择你的资源组

  2. 选择相邻复选框,选择要删除的资源。

  3. 从右边缘附近的顶部菜单中选择“删除”。

  4. 在“删除资源”对话框中输入“delete”

  5. 选择“删除”。

若要删除资源组,请执行以下操作:

  1. 转到 Azure 门户中的资源组。

  2. 在顶部菜单中选择“删除资源组”

  3. 输入资源组名称并选择“删除”来确认删除请求。

下一步