Computer Vision API
Extract rich information from images to categorize and process visual data—and protect your users from unwanted content with this Azure Cognitive Service.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions |
| Power Automate | Standard | All Power Automate regions except the following: - China Cloud operated by 21Vianet |
| Power Apps | Standard | All Power Apps regions except the following: - China Cloud operated by 21Vianet |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://azure.microsoft.com/services/cognitive-services/computer-vision/ |
Creating a connection
The connector supports the following authentication types:
| Default | Required parameters for creating connection. | All regions |
Default
Applicable: All regions
Required parameters for creating connection.
| Name | Type | Description |
|---|---|---|
| Account Key | securestring | Cognitive Services Account Key |
| Site URL | string | Root site url (Example: https://westus.api.cognitive.microsoft.com ).If not specified site url will be defaulted to 'https://westus.api.cognitive.microsoft.com'. |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 1200 | 60 seconds |
Actions
| Analyze Image |
This operation extracts a rich set of visual features based on the image content. |
| Describe Image |
This operation generates a description of an image in human readable language with complete sentences. |
| Describe Image Content |
This operation generates a description of image content in human readable language with complete sentences. |
| Describe Image URL |
This operation generates a description of an image URL in human readable language with complete sentences. |
| Detect Objects |
Generates a list of deteced objects in the supplied image. |
| Generate Thumbnail |
This operation generates a thumbnail image with the user-specified width and height. |
| Get Area of Interest |
Returns a bounding box around the most important area of the image. |
| Optical Character Recognition (OCR) to JSON |
Optical Character Recognition (OCR) detects text in an image and extracts the recognized characters into a machine-usable JSON stream. |
| Optical Character Recognition (OCR) to Text |
Optical Character Recognition (OCR) detects text in an image and extracts the recognized characters into a text file. |
| Recognize Domain Specific Content |
Recognize celebrities or landmarks in an image. |
| Tag Image |
Generates a list of words, or tags, that are relevant to the content of the supplied image. |
Analyze Image
This operation extracts a rich set of visual features based on the image content.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Language
|
language | string |
The service will return recognition results in specified language. |
|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
- Body
- AnalyzeResponse
Describe Image
This operation generates a description of an image in human readable language with complete sentences.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Max Candidates
|
maxCandidates | number |
Maximum number of candidate descriptions to be returned. |
|
|
Language
|
language | string |
The service will return recognition results in specified language. |
|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
- Body
- DescribeResponse
Describe Image Content
This operation generates a description of image content in human readable language with complete sentences.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Max Candidates
|
maxCandidates | number |
Maximum number of candidate descriptions to be returned. |
|
|
Language
|
language | string |
The service will return recognition results in specified language. |
|
|
Image Content
|
Image | True | binary |
Source of the image reference in body. |
Returns
- Body
- DescribeResponse
Describe Image URL
This operation generates a description of an image URL in human readable language with complete sentences.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Max Candidates
|
maxCandidates | number |
Maximum number of candidate descriptions to be returned. |
|
|
Language
|
language | string |
The service will return recognition results in specified language. |
|
|
Image URL
|
url | url |
Source of image reference by URL. |
Returns
- Body
- DescribeResponse
Detect Objects
Generates a list of deteced objects in the supplied image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
- Body
- DetectResponse
Generate Thumbnail
This operation generates a thumbnail image with the user-specified width and height.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Thumbnail Width
|
width | True | number |
Width of the generated thumbnail - recommended is 50 |
|
Thumbnail Height
|
height | True | number |
Height of the generated thumbnail - recommended is 50 |
|
Smart Cropping
|
smartCropping | boolean |
Boolean flag for enabling smart cropping |
|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
Generated thumbnail image
- Thumbnail
- binary
Get Area of Interest
Returns a bounding box around the most important area of the image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
Optical Character Recognition (OCR) to JSON
Optical Character Recognition (OCR) detects text in an image and extracts the recognized characters into a machine-usable JSON stream.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
- JSON Response
- OCRJsonResponse
Optical Character Recognition (OCR) to Text
Optical Character Recognition (OCR) detects text in an image and extracts the recognized characters into a text file.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
- Body
- OCRTextResponse
Recognize Domain Specific Content
Recognize celebrities or landmarks in an image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Domain Model
|
model | True | string |
Supported domain-specific model to recognize in image. |
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
- Body
- DomainModelResponse
Tag Image
Generates a list of words, or tags, that are relevant to the content of the supplied image.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Image Source
|
format | True | string |
Source of the image - either included or by reference url. |
|
Image
|
Image | True | dynamic |
Returns
- Body
- TagResponse
Definitions
DomainModelResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
celebrities
|
result.celebrities | array of object |
Recognized celebrities in image |
|
Celebrity Confidence
|
result.celebrities.confidence | float |
Confidence score that image is of celebrity |
|
Celebrity Name
|
result.celebrities.name | string |
Name of the recognized celebrity |
|
landmarks
|
result.landmarks | array of object |
Recognized landmarks in image |
|
Landmark Confidence
|
result.landmarks.confidence | float |
Confidence score that image is of landmark |
|
Landmark Name
|
result.landmarks.name | string |
Name of the identified landmark |
TagResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
tags
|
tags | array of object |
Set of tags returned from the picture analysis. |
|
Tag Confidence Score
|
tags.confidence | float |
Confidence score of the identified tag. |
|
Tag Name
|
tags.name | string |
Name of the tag identified. |
DetectResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
objects
|
objects | array of object |
Set of objects returned from the picture analysis. |
|
Object confidence score
|
objects.confidence | float |
Confidence score of the identified object. |
|
Object name
|
objects.object | string |
Name of the object identified. |
AreaOfInterestResponse
OCRJsonResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Text Language
|
language | string |
Detected language of the image text. |
|
Regions Array
|
regions | array of object |
Text regions returned. |
OCRTextResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Detected Text
|
text | string |
Text detected in the image analyzed |
AnalyzeResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
categories
|
categories | array of object |
Categories identified from the image |
|
Category Name
|
categories.name | string |
Name of the category identified from the image |
|
Category Confidence Score
|
categories.score | float |
Confidence Score for the image category |
|
Captions
|
description.captions | array of object |
List of captions generated from the image |
|
Caption Confidence Score
|
description.captions.confidence | float |
Confidence score of the image caption |
|
Caption Text
|
description.captions.text | string |
Text caption generated from the image |
|
Tag Names
|
description.tags | array of string |
Collection of tag names. |
|
tags
|
tags | array of object |
Tags identified with confidence scores. |
|
Tag Confidence Score
|
tags.confidence | float |
Confidence score for the identified tags. |
|
Tag Name
|
tags.name | string |
Name of the tag identified. |
DescribeResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Captions
|
description.captions | array of object |
List of captions generated from the image |
|
Caption Confidence Score
|
description.captions.confidence | float |
Confidence score of the image caption |
|
Caption Text
|
description.captions.text | string |
Text caption generated from the image |
|
Tag Names
|
description.tags | array of string |
Collection of tag names. |
binary
This is the basic data type 'binary'.