创建翻译器资源

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

先决条件

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

创建资源

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

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

  • 通过多服务资源类型,可使用单个 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 复制并粘贴到一个方便的位置(例如记事本)。

Screenshot of the Azure portal showing the Keys and Endpoint page of a Translator resource. The keys and endpoints are highlighted.

创建文本翻译客户端

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

  • 若要使用区域资源终结点创建 TextTranslationClient,需要资源 API 密钥和资源所在的区域的名称:

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

如何删除资源或资源组

警告

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

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

  1. 在 Azure 门户中搜索并选择“资源组”,然后选择你的资源组
  2. 选择相邻复选框,选择要删除的资源。
  3. 从右边缘附近的顶部菜单中选择“删除”。
  4. 在“删除资源”对话框中输入“delete”
  5. 选择“删除” 。

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

  1. 转到 Azure 门户中的资源组。
  2. 在顶部菜单中选择“删除资源组”
  3. 输入资源组名称并选择“删除”来确认删除请求。

如何开始使用 Azure AI 翻译 REST API

在我们的快速入门中,你将了解如何将翻译器服务与 REST API 配合使用。

后续步骤