Detect Objects In Stream - Detect Objects In Stream

Service:

Azure AI Services

API-versie:

3.2

Hiermee wordt objectdetectie uitgevoerd op de opgegeven afbeelding. Er worden twee invoermethoden ondersteund: (1) Het uploaden van een afbeelding of (2) het opgeven van een afbeeldings-URL. Er wordt een geslaagd antwoord geretourneerd in JSON. Als de aanvraag is mislukt, bevat het antwoord een foutcode en een bericht om te begrijpen wat er mis is gegaan.

POST {Endpoint}/vision/v3.2/detect

Met optionele parameters:

POST {Endpoint}/vision/v3.2/detect?overload=stream&model-version={model-version}

URI-parameters

Name	In	Vereist	Type	Description
Endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Optionele parameter om de versie van het AI-model op te geven. Geaccepteerde waarden zijn: 'latest', '2021-04-01', '2021-05-01'. De standaardwaarde is 'nieuwste'.

Aanvraagkoptekst

Media Types: "application/octet-stream", "multipart/form-data"

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string

Aanvraagbody

Media Types: "application/octet-stream", "multipart/form-data"

Name	Type	Description
Image	object (file)	Een afbeeldingsstroom.

Antwoorden

Name	Type	Description
200 OK	DetectResult	Het antwoord bevat de gedetecteerde objecten in JSON-indeling.
Other Status Codes	ComputerVisionErrorResponse	Foutreactie.

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Voorbeelden

Successful DetectObjects request

Voorbeeldaanvraag

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/detect?overload=stream


"{binary}"

Voorbeeldrespons

Statuscode:

200

{
  "objects": [
    {
      "rectangle": {
        "x": 0,
        "y": 0,
        "w": 50,
        "h": 50
      },
      "object": "tree",
      "confidence": 0.9,
      "parent": {
        "object": "plant",
        "confidence": 0.95
      }
    }
  ],
  "requestId": "1ad0e45e-b7b4-4be3-8042-53be96103337",
  "metadata": {
    "width": 100,
    "height": 100,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

Definities

Name	Description
BoundingRect	Een begrenzingsvak voor een gebied in een afbeelding.
ComputerVisionError	De API-aanvraagfout.
ComputerVisionErrorCodes	De foutcode.
ComputerVisionErrorResponse	Het ANTWOORD van de API-fout.
ComputerVisionInnerError	Details over de FOUT bij de API-aanvraag.
ComputerVisionInnerErrorCodeValue	De foutcode.
DetectedObject	Een object dat is gedetecteerd in een afbeelding.
DetectResult	Resultaat van een DetectImage-aanroep.
ImageMetadata	Metagegevens van afbeeldingen.
ObjectHierarchy	Een object dat in een afbeelding is gedetecteerd.

BoundingRect

Object

Een begrenzingsvak voor een gebied in een afbeelding.

Name	Type	Description
h	integer (int32)	Hoogte gemeten vanaf het linkerbovenpunt van het gebied, in pixels.
w	integer (int32)	Breedte gemeten vanaf het linkerbovenpunt van het gebied, in pixels.
x	integer (int32)	X-coördinaat van het linkerbovenpunt van het gebied, in pixels.
y	integer (int32)	Y-coördinaat van het linkerbovenpunt van het gebied, in pixels.

ComputerVisionError

Object

De API-aanvraagfout.

Name	Type	Description
code	ComputerVisionErrorCodes	De foutcode.
innererror	ComputerVisionInnerError	Interne fout bevat meer specifieke informatie.
message	string	Een bericht waarin de fout wordt uitgelegd die door de service is gerapporteerd.

ComputerVisionErrorCodes

Inventarisatie

De foutcode.

Waarde	Description
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable

ComputerVisionErrorResponse

Object

Het ANTWOORD van de API-fout.

Name	Type	Description
error	ComputerVisionError	Foutinhoud.

ComputerVisionInnerError

Object

Details over de FOUT bij de API-aanvraag.

Name	Type	Description
code	ComputerVisionInnerErrorCodeValue	De foutcode.
message	string	Foutmelding.

ComputerVisionInnerErrorCodeValue

Inventarisatie

De foutcode.

Waarde	Description
InvalidImageFormat
UnsupportedMediaType
InvalidImageUrl
NotSupportedFeature
NotSupportedImage
Timeout
InternalServerError
InvalidImageSize
BadArgument
DetectFaceError
NotSupportedLanguage
InvalidThumbnailSize
InvalidDetails
InvalidModel
CancelledRequest
NotSupportedVisualFeature
FailedToProcess
Unspecified
StorageException

DetectedObject

Object

Een object dat is gedetecteerd in een afbeelding.

Name	Type	Description
confidence	number (double)	Betrouwbaarheidsscore van het waargenomen object in de afbeelding, als een waarde tussen 0 en 1.
object	string	Label voor het object.
parent	ObjectHierarchy	Het bovenliggende object, vanuit het perspectief van een taxonomie. Het bovenliggende object is een algemenere vorm van dit object. Een 'bulldog' zou bijvoorbeeld een ouder van 'hond' hebben.
rectangle	BoundingRect	Geschatte locatie van het gedetecteerde object.

DetectResult

Object

Resultaat van een DetectImage-aanroep.

Name	Type	Description
metadata	ImageMetadata	Metagegevens van afbeeldingen.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Versie van het AI-model.
objects	DetectedObject[]	Een matrix met gedetecteerde objecten.
requestId	string	Id van de REST API-aanvraag.

ImageMetadata

Object

Metagegevens van afbeeldingen.

Name	Type	Description
format	string	Afbeeldingsindeling.
height	integer (int32)	Hoogte van afbeelding, in pixels.
width	integer (int32)	Breedte van afbeelding, in pixels.

ObjectHierarchy

Object

Een object dat in een afbeelding is gedetecteerd.

Name	Type	Description
confidence	number (double)	Betrouwbaarheidsscore van het waargenomen object in de afbeelding, als een waarde tussen 0 en 1.
object	string	Label voor het object.
parent	ObjectHierarchy	Het bovenliggende object, vanuit het perspectief van een taxonomie. Het bovenliggende object is een algemenere vorm van dit object. Een 'bulldog' zou bijvoorbeeld een ouder van 'hond' hebben.