创建“翻译”资源

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

先决条件

若要开始,你需要一个有效的 Azure 帐户

创建资源

使用 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 请求中使用此终结点。 有关详细信息,请参阅基 URL

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

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

  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>');
    

如何删除资源或资源组

警告

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

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

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

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

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

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

  5. 选择“删除” 。

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

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

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

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

下一步