Analyze Image By Domain In Stream - Analyze Image By Domain In Stream

Dienst:

Azure AI Services

API-Version:

3.2

Dieser Vorgang erkennt Inhalte innerhalb eines Bilds, indem ein domänenspezifisches Modell angewendet wird. Die Liste der domänenspezifischen Modelle, die von der Computer Vision-API unterstützt werden, kann mithilfe der GET-Anforderung "/models" abgerufen werden. Derzeit stellt die API die folgenden domänenspezifischen Modelle bereit: Prominente, Wahrzeichen. Zwei Eingabemethoden werden unterstützt : (1) Hochladen eines Bilds oder (2) Angeben einer Bild-URL. Eine erfolgreiche Antwort wird in JSON zurückgegeben. Wenn die Anforderung fehlgeschlagen ist, enthält die Antwort einen Fehlercode und eine Meldung, um zu verstehen, was nicht geklappt hat.

POST {Endpoint}/vision/v3.2/models/{model}/analyze

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte.
model	path	True	string	Der zu erkennende domänenspezifische Inhalt.
language	query		string	Die gewünschte Sprache für die Ausgabegenerierung. Wenn dieser Parameter nicht angegeben ist, lautet der Standardwert "en". Eine Liste der unterstützten Sprachen finden Sie unter https://aka.ms/cv-languages.
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	DomainModelResults	Analyseergebnis basierend auf dem Domänenmodell.
Other Status Codes	ComputerVisionErrorResponse	Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Successful AnalyzeImageByDomain request

Beispielanforderung

HTTP

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


"{binary}"

Beispiel für eine Antwort

Statuscode:

200

{
  "requestId": "f0027b4b-dc0d-4082-9228-1545ed246b03",
  "metadata": {
    "width": 1500,
    "height": 1000,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01",
  "result": {
    "celebrities": [
      {
        "name": "Satya Nadella",
        "faceRectangle": {
          "left": 597,
          "top": 162,
          "width": 248,
          "height": 248
        },
        "confidence": 0.999028444
      }
    ]
  }
}

Definitionen

Name	Beschreibung
ComputerVisionError	Der API-Anforderungsfehler.
ComputerVisionErrorCodes	Der Fehlercode.
ComputerVisionErrorResponse	Die API-Fehlerantwort.
ComputerVisionInnerError	Details zum API-Anforderungsfehler.
ComputerVisionInnerErrorCodeValue	Der Fehlercode.
DomainModelResults	Ergebnis der Bildanalyse mithilfe eines bestimmten Domänenmodells, einschließlich zusätzlicher Metadaten.
ImageMetadata	Bildmetadaten.

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

DomainModelResults

Objekt

Ergebnis der Bildanalyse mithilfe eines bestimmten Domänenmodells, einschließlich zusätzlicher Metadaten.

Name	Typ	Beschreibung
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.

ImageMetadata

Objekt

Bildmetadaten.

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