Microsoft Cognitiveservices Computervision
Microsoft Cognitiveservices Computervision is a Microsoft Cognitive Services API for analyzing images and extracting visual information such as objects, text, tags, and descriptions.
- Base URL:
https://westcentralus.api.cognitive.microsoft.com/vision/v2.1 - Auth:
header:Ocp-Apim-Subscription-Key(pass your key via theapiKeyinput)
Operations
listmodels— GET /models — This operation returns the list of domain-specific models that are supported byanalyzeimage— POST /analyze — This operation extracts a rich set of visual features based on the image contentgetareaofinterest— POST /areaOfInterest — This operation returns a bounding box around the most important area of the imagdescribeimage— POST /describe — This operation generates a description of an image in human readable language widetectobjects— POST /detect — Performs object detection on the specified image. Two input methods are supportgeneratethumbnail— POST /generateThumbnail — This operation generates a thumbnail image with the user-specified width and hei
Inputs
apiKey— your microsoft-cognitiveservices-computervision API keyoperation— one of the operations above- path parameters when an operation's path contains
{...} query— optional JSON object of query paramsbody— JSON object for create/update ops
Example
operation: listmodels
apiKey: <your key>
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
erroroperationresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey |
string | yes | — | DEPRECATED — bind an API Key credential to the task with credentialName instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change. |
operation |
string | yes | — | One of: listmodels, analyzeimage, getareaofinterest, describeimage, detectobjects, generatethumbnail |
query |
string | no | — | Optional query params as a JSON object string, e.g. {"limit": 10}. |
body |
string | no | — | Request body as a JSON object string (for create/update operations). |