Detect Objects - Detect Objects

Führt die Objekterkennung für das angegebene Bild aus. Zwei Eingabemethoden werden unterstützt: (1) Hochladen eines Bilds oder (2) Angeben einer Bild-URL. Eine erfolgreiche Antwort wird im JSON-Format zurückgegeben. Wenn die Anforderung fehlgeschlagen ist, enthält die Antwort einen Fehlercode und eine Meldung, um zu verstehen, was schiefgelaufen ist.

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

URI-Parameter

Name In Required Type Description
Endpoint
path True
  • string

Unterstützte Cognitive Services Endpunkte.

Anforderungsheader

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Anforderungstext

Name Required Type Description
url True
  • string

Öffentlich erreichbare URL eines Bilds.

Antworten

Name Type Description
200 OK

Die Antwort enthält die erkannten Objekte im JSON-Format.

Other Status Codes

Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Beispiele

Successful DetectObjects request

Sample Request

POST https://westus.api.cognitive.microsoft.com/vision/v3.1/detect
Ocp-Apim-Subscription-Key: {API key}
{
  "url": "{url}"
}

Sample Response

{
  "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"
  }
}

Definitionen

BoundingRect

Ein Begrenzungsfeld für einen Bereich innerhalb eines Bilds.

ComputerVisionError

Details zum API-Anforderungsfehler.

ComputerVisionErrorCodes

Der Fehlercode.

DetectedObject

Ein in einem Bild erkanntes Objekt.

DetectResult

Ergebnis eines DetectImage-Aufrufs.

ImageMetadata

Bildmetadaten.

ImageUrl
ObjectHierarchy

Ein innerhalb eines Bilds erkanntes Objekt.

BoundingRect

Ein Begrenzungsfeld für einen Bereich innerhalb eines Bilds.

Name Type Description
h
  • integer

Die Höhe wird vom linken oberen Punkt des Bereichs in Pixel gemessen.

w
  • integer

Die Breite, die vom linken oberen Punkt des Bereichs in Pixel gemessen wird.

x
  • integer

X-Koordinate des oberen linken Punkts des Bereichs in Pixel.

y
  • integer

Y-Koordinate des oberen linken Punkts des Bereichs in Pixel.

ComputerVisionError

Details zum API-Anforderungsfehler.

Name Type Description
code

Der Fehlercode.

message
  • string

Eine Meldung, in der der vom Dienst gemeldete Fehler erläutert wird.

requestId
  • string

Ein eindeutiger Anforderungsbezeichner.

ComputerVisionErrorCodes

Der Fehlercode.

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

DetectedObject

Ein in einem Bild erkanntes Objekt.

Name Type Description
confidence
  • number

Die Konfidenz-Bewertung, dass das Objekt im Bild als Wert zwischen 0 und 1 beobachtet wurde.

object
  • string

Bezeichnung für das -Objekt.

parent

Das übergeordnete Objekt aus Taxonomiesicht. Das übergeordnete Objekt ist eine allgemeinere Form dieses Objekts. Beispielsweise würde ein "Bulldog" ein übergeordnetes Element von "Dog" haben.

rectangle

Ungefähre Position des erkannten Objekts.

DetectResult

Ergebnis eines DetectImage-Aufrufs.

Name Type Description
metadata

Bildmetadaten.

objects

Ein Array von erkannten Objekten.

requestId
  • string

ID der REST-API-Anforderung.

ImageMetadata

Bildmetadaten.

Name Type Description
format
  • string

Bildformat.

height
  • integer

Bildhöhe in Pixel.

width
  • integer

Bildbreite in Pixel.

ImageUrl

Name Type Description
url
  • string

Öffentlich erreichbare URL eines Bilds.

ObjectHierarchy

Ein innerhalb eines Bilds erkanntes Objekt.

Name Type Description
confidence
  • number

Die Konfidenz-Bewertung, dass das Objekt im Bild als Wert zwischen 0 und 1 beobachtet wurde.

object
  • string

Bezeichnung für das -Objekt.

parent

Das übergeordnete Objekt aus Taxonomiesicht. Das übergeordnete Objekt ist eine allgemeinere Form dieses Objekts. Beispielsweise würde ein "Bulldog" ein übergeordnetes Element von "Dog" haben.