Get Area Of Interest In Stream - Get Area Of Interest In Stream

Dienst:

Azure AI Services

API-Version:

3.2

Dieser Vorgang gibt ein umgebendes Feld um den wichtigsten Bereich des Bilds zurück. Eine erfolgreiche Antwort wird in JSON zurückgegeben. Wenn die Anforderung fehlgeschlagen ist, enthält die Antwort einen Fehlercode und eine Meldung, um zu ermitteln, was schief gelaufen ist. Bei Einem Fehler werden der Fehlercode und eine Fehlermeldung zurückgegeben. Der Fehlercode kann eine von InvalidImageUrl, InvalidImageFormat, InvalidImageSize, NotSupportedImage, FailedToProcess, Timeout oder InternalServerError sein.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Optionaler Parameter zum Angeben der Version des KI-Modells. Akzeptierte Werte sind: "latest", "2021-04-01", "2021-05-01". Der Standardwert ist "latest".

Anforderungsheader

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

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string

Anforderungstext

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

Name	Typ	Beschreibung
Image	object (file)	Ein Bildstream.

Antworten

Name	Typ	Beschreibung
200 OK	AreaOfInterestResult	Die Antwort enthält den extrahierten Bereich des JSON-Formats.
Other Status Codes	ComputerVisionErrorResponse	Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Successful GetAreaOfInterest request

Beispielanforderung

HTTP

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


"{binary}"

Beispiel für eine Antwort

Statuscode:

200

{
  "areaOfInterest": {
    "h": 951,
    "w": 950,
    "x": 160,
    "y": 0
  },
  "requestId": "ed2de1c6-fb55-4686-b0da-4da6e05d283f",
  "metadata": {
    "format": "Jpeg",
    "height": 951,
    "width": 1378
  },
  "modelVersion": "2021-04-01"
}

Definitionen

Name	Beschreibung
AreaOfInterestResult	Ergebnis des AreaOfInterest-Vorgangs.
BoundingRect	Ein umgebendes Feld für einen Bereich innerhalb eines Bilds.
ComputerVisionError	Der API-Anforderungsfehler.
ComputerVisionErrorCodes	Der Fehlercode.
ComputerVisionErrorResponse	Die API-Fehlerantwort.
ComputerVisionInnerError	Details zum API-Anforderungsfehler.
ComputerVisionInnerErrorCodeValue	Der Fehlercode.
ImageMetadata	Bildmetadaten.

AreaOfInterestResult

Objekt

Ergebnis des AreaOfInterest-Vorgangs.

Name	Typ	Beschreibung
areaOfInterest	BoundingRect	Ein umgebendes Feld für einen Interessanten Bereich innerhalb eines Bilds.
metadata	ImageMetadata	Bildmetadaten.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Version des KI-Modells.
requestId	string	ID der REST-API-Anforderung.

BoundingRect

Objekt

Ein umgebendes Feld für einen Bereich innerhalb eines Bilds.

Name	Typ	Beschreibung
h	integer (int32)	Höhe gemessen vom linken oberen Punkt des Bereichs in Pixel.
w	integer (int32)	Breite gemessen vom oberen linken Punkt des Bereichs in Pixel.
x	integer (int32)	X-Koordinate des oberen linken Punkts des Bereichs in Pixel.
y	integer (int32)	Y-Koordinate des oberen linken Punkts des Bereichs in Pixel.

ComputerVisionError

Objekt

Der API-Anforderungsfehler.

Name	Typ	Beschreibung
code	ComputerVisionErrorCodes	Der Fehlercode.
innererror	ComputerVisionInnerError	Innerer Fehler enthält spezifischere Informationen.
message	string	Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt.

ComputerVisionErrorCodes

Enumeration

Der Fehlercode.

Wert	Beschreibung
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

Objekt

Die API-Fehlerantwort.

Name	Typ	Beschreibung
error	ComputerVisionError	Fehlerinhalte.

ComputerVisionInnerError

Objekt

Details zum API-Anforderungsfehler.

Name	Typ	Beschreibung
code	ComputerVisionInnerErrorCodeValue	Der Fehlercode.
message	string	Fehlermeldung.

ComputerVisionInnerErrorCodeValue

Enumeration

Der Fehlercode.

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

ImageMetadata

Objekt

Bildmetadaten.

Name	Typ	Beschreibung
format	string	Bildformat.
height	integer (int32)	Bildhöhe in Pixel.
width	integer (int32)	Bildbreite in Pixel.