Azure Government 中的 Azure AI 服務
本文章提供使用電腦視覺、臉部 API、文字分析和翻譯工具 Azure AI 服務開發人員指導。 如需功能變化和限制,請參閱 比較 Azure Government 與全域 Azure。
必要條件
注意
建議您使用 Azure Az PowerShell 模組來與 Azure 互動。 請參閱安裝 Azure PowerShell 以開始使用。 若要了解如何移轉至 Az PowerShell 模組,請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。
佈建 Azure AI 服務帳戶
若要存取任何 Azure AI 服務 API,您必須先針對您想要存取的每個 API 布建 Azure AI 服務帳戶。 您可以在 Azure Government 入口網站中建立 Azure AI 服務,或使用 Azure PowerShell 來存取本文章中所述的 API 和服務。
注意
您必須為您想要存取的每個 API 完成建立帳戶和擷取帳戶金鑰的流程 (如下所述)。
確定您已在您的帳戶中註冊認知服務資源提供者。
您可以執行下列 PowerShell 命令執行這項作業:
Get-AzResourceProvider
如果您沒有看到
Microsoft.CognitiveServices
,您必須執行下列命令來註冊資源提供者:Register-AzResourceProvider -ProviderNamespace Microsoft.CognitiveServices
在下列 PowerShell 命令中,將
<rg-name>
、<name-of-your-api>
和<location-of-resourcegroup>
取代為您相關的帳戶資訊。將
type of API
標籤取代為您要存取的下列任何 API:- ComputerVision
- 臉部
- 語言
- TextTranslation
- OpenAI
New-AzCognitiveServicesAccount -ResourceGroupName '<rg-name>' -name '<name-of-your-api>' -Type <type of API> -SkuName S0 -Location '<location-of-resourcegroup>'
範例:
New-AzCognitiveServicesAccount -ResourceGroupName 'resourcegrouptest' -name 'myFaceAPI' -Type Face -SkuName S0 -Location 'usgovvirginia'
執行命令後,應該會看到如下的結果:
複製並儲存「端點」屬性,因為您在呼叫 API 時將需要。
擷取帳戶金鑰
您必須擷取帳戶金鑰才能存取特定 API。
在下列 PowerShell 命令中,將<youraccountname>
標籤取代為您在上面建立的帳戶名稱。 將rg-name
標籤取代為您的資源群組名稱。
Get-AzCognitiveServicesAccountKey -Name <youraccountname> -ResourceGroupName 'rg-name'
範例:
Get-AzCognitiveServicesAccountKey -Name myFaceAPI -ResourceGroupName 'resourcegrouptest'
複製並儲存第一個金鑰,因為您需要用來呼叫 API。
現在您已準備好呼叫 API。
遵循 API 快速入門
下列快速入門將協助您開始使用 Azure Government 中的 Azure AI 服務所提供的 API。
注意
Azure Government 中存取 Azure AI 服務資源的 URI 與 Azure 不同。 如需 Azure Government 端點的清單,請參閱 比較 Azure Government 和全域 Azure。
- Azure AI 視覺 | 快速入門
- Azure Face | 快速入門
- Azure AI 語言 | 快速入門
- Azure AI 翻譯工具 | 快速入門
注意
翻譯工具服務的虛擬網路支援僅限於
US Gov Virginia
區域。 用來存取 API 的 URI 為:https://<your-custom-domain>.cognitiveservices.azure.us/translator/text/v3.0
- 建立資源之後,您可以在 Azure Government 入口網站的概觀刀鋒視窗中找到您的自訂網域端點。
有兩個區域:
US Gov Virginia
和US Gov Arizona
。
- Azure OpenAI | 快速入門
後續步驟
- 訂閱 Azure Government 部落格
- 使用「azure-gov」標籤,在 Stack Overflow 取得協助