使用英语阅读

通过


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

快速入门:创建 Azure AI 服务资源

选择编程语言或工具

了解如何创建和管理 Azure AI 服务资源。 使用 Azure AI 服务资源,可以通过一组凭据访问多个 Azure AI 服务。

可以通过两种不同的资源类型访问 Azure AI 服务:

  • Azure AI 服务多服务资源:
    • 通过一组凭据访问多个 Azure AI 服务。
    • 合并来自你使用的服务的计费。
  • 单服务资源,例如人脸和视觉:
    • 通过为每个创建的服务设置的一组唯一凭据访问单个 Azure AI 服务。
    • 大多数 Azure AI 服务提供免费层来试用。

Azure AI 服务是你在 Azure 订阅下创建的 Azure 资源。 创建资源后,可以使用生成的密钥和终结点对应用程序进行身份验证。

具有多服务资源的受支持服务

多服务资源支持通过一组凭据访问以下 Azure AI 服务。 某些服务可通过多服务资源和单服务资源获得。

提示

建议尽可能使用 Azure AI 服务资源(其中 API 种类为 AIServices)通过一组凭据访问多个 Azure AI 服务。 对于无法通过多服务资源获得的服务(如人脸和自定义视觉),可以创建单服务资源。

服务 说明 种类(通过 API)
Azure OpenAI 服务图标 Azure OpenAI 执行各种自然语言任务。 AIServices
OpenAI
Content Safety 图标 内容安全 用于检测不需要的内容的 AI 服务。 AIServices
ContentSafety
自定义视觉图标 自定义视觉 为你的业务自定义图像识别。 CustomVision.Prediction(仅限预测)
CustomVision.Training(仅限训练)
文档智能图标 文档智能 将文档转换为智能数据驱动解决方案。 AIServices
FormRecognizer
人脸图标 人脸 检测和识别图像中的人和情感。 Face
语言图标 语言 使用行业领先的自然语言理解功能构建应用。 AIServices
TextAnalytics
语音图标 语音 语音转文本、文本转语音、翻译和说话人辨识。 AIServices
Speech
翻译器图标 翻译工具 使用 AI 支持的翻译技术翻译超过 100 种正在使用、处于危险和濒危的语言和方言。 AIServices
TextTranslation
视觉图标 视觉 分析图像和视频中的内容。 AIServices(训练和预测)
ComputerVision

先决条件

创建新的 Azure AI 服务资源

门户中的“Azure AI 服务”>“Azure AI 服务”下列出了 Azure AI 服务多服务资源。 查找如下所示的徽标:

Azure 门户中 Azure AI 服务资源的屏幕截图。

重要

Azure 提供了多个名为 Azure AI 服务的资源种类。 请务必选择“Azure AI 服务”>“Azure AI 服务”(徽标如上所示)下列出的资源类型

若要创建 Azure AI 服务资源,请按照以下说明操作:

  1. 选择此链接,创建 Azure AI 服务资源:https://portal.azure.com/#create/Microsoft.CognitiveServicesAIServices

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

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

    “创建多服务资源”屏幕

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

提示

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

清理资源

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

  1. 在 Azure 门户中展开左侧的菜单,打开服务菜单,然后选择“资源组”以显示资源组的列表。
  2. 找到包含要删除的资源的资源组。
  3. 如果要删除整个资源组,请选择资源组名称。 在下一页上,选择“删除资源组”并进行确认。
  4. 如果想要仅删除 Azure AI 服务资源,请选择资源组以查看其中包含的所有资源。 在下一页上,依次选择要删除的资源、该行的省略号菜单、“删除”。

使用本快速入门,以通过 Azure 命令行接口 (CLI) 命令创建 Azure AI 服务资源。

先决条件

安装 Azure CLI 并登录

安装 Azure CLI。 若要登录到本地安装的 CLI,请运行 az login 命令:

az login

创建新的资源组

在创建 Azure AI 服务资源之前,必须具有 Azure 资源组才能包含该资源。 在创建新资源时,可以新建资源组,也可以使用现有资源组。 本文介绍如何创建新资源组。

若要创建资源,需要为订阅提供一个可用的 Azure 位置。 可以使用 az account list-locations 命令检索可用位置的列表。 可以从多个位置访问大部分 Azure AI 服务。 选择离你最近的位置,或查看哪些位置可供服务使用。

重要

  • 请记住 Azure 位置,因为在调用 Azure AI 服务资源时需要使用该位置。
  • 某些 Azure AI 服务的可用性因区域而异。 有关详细信息,请参阅 Azure 产品在各区域中的推出情况
az account list-locations --query "[].{Region:name}" --out table

选择 Azure 位置后,在 Azure CLI 中使用 az group create 命令创建新的资源组。 在以下示例中,请将 Azure 位置 westus2 替换为你的订阅可用的某个 Azure 位置。

az group create --name ai-services-resource-group --location westus2

创建 Azure AI 服务多服务资源

要创建并订阅新的 Azure AI 服务资源,请使用 az cognitiveservices account create 命令。 此命令会将新的可计费资源添加到前面创建的资源组。 创建新资源时,需要知道要使用的服务的种类,以及其定价层(或 SKU)和 Azure 位置。

重要

Azure 提供了多个 Azure AI 服务资源种类。 请确保创建的资源种类的 kindAIServices

可以使用以下命令创建名为 multi-service-resource 的标准 S0 Azure AI 服务多服务资源。

az cognitiveservices account create --name multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

提示

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

获取资源的当前配额使用情况

使用 az cognitiveservices account list-usage 命令获取资源的使用情况。

az cognitiveservices account list-usage --name multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

清理资源

如果想要清理并移除 Azure AI 服务资源,可以删除它或资源组。 删除资源组也会删除该组中包含的任何其他资源。

若要删除资源组及其关联的资源,请使用 az group delete command

az group delete --name ai-services-resource-group

使用本快速入门,以通过 Azure PowerShell 命令创建 Azure AI 服务资源。

先决条件

安装 Azure PowerShell 并登录

安装 Azure PowerShell。 若要登录,请运行 Connect-AzAccount 命令:

Connect-AzAccount

创建新的 Azure AI 服务资源组

在创建 Azure AI 服务资源之前,必须具有 Azure 资源组才能包含该资源。 在创建新资源时,可以新建资源组,也可以使用现有资源组。 本文介绍如何创建新资源组。

若要创建资源,需要为订阅提供一个可用的 Azure 位置。 可以使用 Get-AzLocation 命令检索可用位置的列表。 可以从多个位置访问大部分 Azure AI 服务。 选择离你最近的位置,或查看哪些位置可供服务使用。

重要

  • 请记住 Azure 位置,因为在调用 Azure AI 服务资源时需要使用该位置。
  • 某些 Azure AI 服务的可用性因区域而异。 有关详细信息,请参阅 Azure 产品在各区域中的推出情况
Get-AzLocation | Select-Object -Property Location, DisplayName

获得 Azure 位置后,使用 New-AzResourceGroup 命令在 Azure PowerShell 创建新的资源组。 在以下示例中,请将 Azure 位置 westus2 替换为你的订阅可用的某个 Azure 位置。

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

创建 Azure AI 服务多服务资源

若要创建并订阅新的 Azure AI 服务资源,请使用 New-AzCognitiveServicesAccount 命令。 此命令会将新的可计费资源添加到前面创建的资源组。 创建新资源时,需要知道要使用的服务的种类,以及其定价层(或 SKU)和 Azure 位置:

重要

Azure 提供了多个 Azure AI 服务资源种类。 请确保创建的资源种类的 Type(种类)为 AIServices

可以使用以下命令创建名为 multi-service-resource 的标准 S0 Azure AI 服务多服务资源。

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name multi-service-resource -Type AIServices -SkuName S0 -Location westus2

提示

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

获取资源的当前配额使用情况

使用 Get-AzCognitiveServicesAccountUsage 命令获取资源的使用情况。

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name multi-service-resource

清理资源

如果想要清理并移除 Azure AI 服务资源,可以删除它或资源组。 删除资源组也会删除该组中包含的任何其他资源。

若要删除资源组及其关联的资源,请使用 Remove-AzResourceGroup 命令。

Remove-AzResourceGroup -Name ai-services-resource-group

定价

定价层(以及你的账单金额)基于你使用身份验证信息发送的事务数。 每个定价层指定:

  • 每秒允许的最大事务数 (TPS)。
  • 在定价层中启用的服务功能。
  • 预定义事务数的成本。 根据定价详细信息中为服务所指定的内容,超过此数字将导致额外费用。