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

快速入门:使用 Azure 门户创建认知服务资源

使用此快速入门开始使用 Azure 认知服务。 在 Azure 门户中创建认知服务资源后,你将获得用于验证应用程序的终结点和密钥。

Azure 认知服务是包含 REST API 和客户端库 SDK 的基于云的服务,可帮助开发人员将认知智能内置于应用程序,而无需具备直接的人工智能 (AI) 或数据科学技能或知识。 借助 Azure 认知服务,开发人员可以通过能够看、听、说、理解甚至开始推理的认知解决方案,轻松将认知功能添加到他们的应用程序中。

可以通过两种不同的资源来访问 Azure 认知服务:多服务资源或单一服务资源。

  • 多服务资源:
    • 通过单个密钥和终结点访问多个 Azure 认知服务。
    • 合并来自你使用的服务的计费。
  • 单服务资源:
    • 对于创建的每个服务,使用唯一密钥和终结点访问单个 Azure 认知服务。
    • 使用免费层试用服务。

先决条件

  • 一个有效的 Azure 订阅 - 免费创建订阅
  • 你的 Azure 帐户必须分配有认知服务参与者角色,你才能同意负责的 AI 条款并创建资源。 若要将此角色分配给你的帐户,请按照分配角色文档中的步骤进行操作,或与管理员联系。

新建 Azure 认知服务资源

多服务资源在门户中名为“认知服务”。 多服务资源允许访问以下认知服务:

  • 决策 - 内容审查器
  • 语言 - 语言、翻译
  • 语音 - 语音
  • 视觉 - 计算机视觉、自定义视觉和人脸
  1. 可以选择以下链接来创建 Azure 认知多服务资源:创建认知服务资源

  2. 在“创建”页中提供以下信息:

    项目详细信息 说明
    订阅 选择一个可用的 Azure 订阅。
    资源组 将包含认知服务资源的 Azure 资源组。 可以创建新组或将其添加到预先存在的组。
    区域 认知服务实例的位置。 不同位置可能会导致延迟,但不会影响资源的运行时可用性。
    名称 认知服务资源的描述性名称。 例如,MyCognitiveServicesResource
    定价层 认知服务帐户的费用取决于你所选的选项和你的使用情况。 有关详细信息,请参阅 API 定价详细信息

    Multi-service resource creation screen

  3. 根据需要为资源配置其他设置,阅读并接受条件(如果适用),然后选择“审阅并创建”。

提示

如果订阅不允许创建认知服务资源,则可能需要使用 Azure 门户PowerShell 命令Azure CLI 命令启用 Azure 资源提供程序的功能。 如果你不是订阅所有者,可请求订阅所有者或具有管理员角色的人员帮助你完成注册,或请求向你的帐户授予 /register/action 特权 。

获取资源的密钥

  1. 成功部署资源后,选择“后续步骤”>“转到资源”。

    Get resource keys screen

  2. 从打开的快速入门窗格中,可以访问资源终结点并管理密钥。

  3. 如果你错过了前面的步骤,或者需要在以后查找资源,请转到 Azure 服务主页。 在这里,可以查看最近的资源,选择“我的资源”,或使用搜索框按名称查找资源。

    Find resource keys from home screen

配置用于身份验证的环境变量

应用程序需要对它们使用的认知服务的访问进行身份验证。 若要进行身份验证,我们建议创建一个环境变量来存储 Azure 资源的密钥。

获得密钥后,将其写入运行应用程序的本地计算机上的新环境变量。 若要设置环境变量,请打开控制台窗口,并遵照适用于操作系统的说明。 将 your-key 替换为资源的密钥之一。

setx COGNITIVE_SERVICE_KEY "your-key"

添加环境变量后,可能需要重启任何正在运行的、需要读取环境变量的程序(包括控制台窗口)。 例如,如果使用 Visual Studio 作为编辑器,请在运行示例之前重启 Visual Studio。

清理资源

如果想要清理并删除认知服务订阅,可以删除资源或资源组。 删除资源组也会删除该组中包含的任何其他资源。

  1. 在 Azure 门户中展开左侧的菜单,打开服务菜单,然后选择“资源组”以显示资源组的列表。
  2. 找到包含要删除的资源的资源组。
  3. 右键单击资源组列表。 选择“删除资源组”并进行确认。

如果需要恢复已删除的资源,请参阅恢复已删除的认知服务资源

另请参阅