在本文中,你将了解如何在 Azure 门户中创建翻译器资源。 Azure AI 翻译是一项基于云的机器翻译服务,是 Azure AI 服务系列的一部分。 Azure 资源是你创建的服务实例。 对 Azure AI 服务的所有 API 请求都需要一个终结点 URL 和一个只读密钥,用于进行访问身份验证。
你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
创建“翻译”资源
先决条件
若要开始,你需要一个有效的 Azure 帐户。 如果没有帐户,可以创建有效期为 12 个月的免费订阅。
创建资源
使用 Azure 帐户,可以通过两种不同的资源类型访问翻译服务:
完成项目和实例详细信息
确定要用于访问翻译服务的资源类型后,可以输入项目和实例的详细信息。
订阅。 选择一个可用的 Azure 订阅。
资源组。 可以创建新资源组,或将资源添加到共享相同生命周期、权限和策略的预先存在的资源组。
资源区域。 选择“全球”,除非你的业务或应用程序需要特定区域。 如果计划配合使用文档翻译功能与托管标识授权,请选择一个地理区域,例如“美国东部”。
名称. 输入资源的名称。 所选名称在 Azure 中必须唯一。
注意
如果你使用的是需要自定义域终结点的翻译功能(例如文档翻译),则你在“名称”字段中输入的值将是该终结点的自定义域名参数。
定价层。 选择满足你需求的定价层:
- 每个订阅都有一个免费层。
- 免费层具有与付费计划相同的特性和功能,并且不会过期。
- 每个订阅仅提供一个免费层资源。
- 仅付费层支持文档翻译。 Language Studio 支持 S1 和 D3 实例层。 如果只是要试用文档翻译,请选择“标准 S1 实例层”。
如果创建多服务资源,“基本信息”选项卡底部的链接提供了有关服务适当操作的技术文档。
选择“查看 + 创建” 。
查看服务条款,然后选择“创建”以部署资源。
成功部署资源后,选择“转到资源”。
身份验证密钥和终结点 URL
所有 Azure AI 服务 API 请求都需要终结点 URL 和只读密钥来进行身份验证。
身份验证密钥。 密钥是在每次请求翻译服务时传递的唯一字符串。 可以通过查询字符串参数传递密钥,或在 HTTP 请求标头中指定密钥。
终结点 URL。 请在 API 请求中使用“全球”终结点,除非你需要特定的 Azure 区域或自定义终结点。 有关详细信息,请参阅基 URL。 “全球”终结点 URL 为
api.cognitive.microsofttranslator.com
。
获取身份验证密钥和终结点
若要对翻译器资源的连接进行身份验证,需要查找其密钥和终结点。
部署新资源后,选择“转到资源”或直接转到资源页。
在左侧导航窗格中的“资源管理”下,选择“密钥和终结点”。
将密钥和终结点 URL 复制并粘贴到一个方便的位置(例如记事本)。
创建文本翻译客户端
文本翻译支持全局终结点和区域终结点。 获得身份验证密钥后,需要创建 TextTranslationClient
的实例,使用 AzureKeyCredential
进行身份验证,以便与文本翻译服务进行交互:
若要使用全局资源终结点创建
TextTranslationClient
,需要资源 API 密钥:AzureKeyCredential credential = new('<apiKey>'); TextTranslationClient client = new(credential);
若要使用区域资源终结点创建
TextTranslationClient
,需要资源 API 密钥和资源所在的区域的名称:AzureKeyCredential credential = new('<apiKey>'); TextTranslationClient client = new(credential, '<region>');
创建文档翻译客户端
使用文档翻译 API 跨语言异步翻译大量文本和多个文档。 批量翻译过程需要一个 Azure Blob 存储帐户,其中包含源文档和翻译文档的存储容器。
目前,在使用 S1 标准服务计划(即用即付)或 D3 批量折扣计划的翻译器(单服务)资源中支持文档翻译。
“有关为文档翻译创建翻译器资源的详细信息,请参阅先决条件:使用文档翻译。
如何删除资源或资源组
警告
删除资源组会删除组中包含的所有资源。
若要删除资源,请执行以下操作:
在 Azure 门户中搜索并选择“资源组”,然后选择你的资源组。
选择相邻复选框,选择要删除的资源。
从右边缘附近的顶部菜单中选择“删除”。
在“删除资源”对话框中输入“delete”。
选择“删除”。
若要删除资源组,请执行以下操作:
转到 Azure 门户中的资源组。
在顶部菜单中选择“删除资源组”。
输入资源组名称并选择“删除”来确认删除请求。