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

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

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

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

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

先决条件

  • 有效的 Azure 订阅 - 创建试用订阅
  • 你的 Azure 帐户必须分配有认知服务参与者角色,你才能同意负责的 AI 条款并创建资源。 请与管理员联系将此角色分配给你的帐户。

新建 Azure 认知服务资源

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

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

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

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

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

另请参阅