Describe local image with Azure Cognitive Services Computer Vision API in PowerShell

cscv-describe-image-binary.ps1

# Describe local image with Azure Cognitive Services Computer Vision API in PowerShell

$ComputerVisionAPILocation = "westeurope";
$ComputerVisionAPIURL = "https://$ComputerVisionAPILocation.api.cognitive.microsoft.com/vision/v2.0";
$ComputerVisionAPIKey = "YOUR_KEY_GOES_HERE";

$ComputerVisionAPIAnalyzeTemplateURL = ($ComputerVisionAPIURL + "//describe?maxCandidates={0}")
$maxCandidates = 10;


$ImageFilename = "C:\Temp\cognitive\20180804-104929-GH01C12-S00.jpg";

$Response = Invoke-WebRequest `
    -Uri ($ComputerVisionAPIAnalyzeTemplateURL -f $maxCandidates) `
    -Headers @{'Ocp-Apim-Subscription-Key' = $ComputerVisionAPIKey} `
    -Body ([System.IO.File]::ReadAllBytes($ImageFilename)) `
    -ContentType "application/octet-stream" `
    -Method "Post" `
    -ErrorAction Stop `
    -UseBasicParsing;

$Response.Content | Out-File ([System.IO.Path]::ChangeExtension($ImageFilename, "describe.json")) -Encoding UTF8;