Detect Objects In Stream - Detect Objects In Stream

Service:

Azure AI Services

Version d'API:

3.2

Effectue la détection d’objets sur l’image spécifiée. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécifiant une URL d’image. Une réponse réussie est retournée au format JSON. Si la demande a échoué, la réponse contient un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string	Points de terminaison Cognitive Services pris en charge.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Paramètre facultatif pour spécifier la version du modèle IA. Les valeurs acceptées sont les suivantes : « latest », « 2021-04-01 », « 2021-05-01 ». La valeur par défaut est « latest ».

En-tête de la demande

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

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string

Corps de la demande

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

Nom	Type	Description
Image	object (file)	Flux d’images.

Réponses

Nom	Type	Description
200 OK	DetectResult	La réponse inclut les objets détectés au format JSON.
Other Status Codes	ComputerVisionErrorResponse	Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Successful DetectObjects request

Exemple de requête

HTTP

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


"{binary}"

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
BoundingRect	Cadre englobant d’une zone à l’intérieur d’une image.
ComputerVisionError	Erreur de demande d’API.
ComputerVisionErrorCodes	Code d’erreur.
ComputerVisionErrorResponse	Réponse d’erreur de l’API.
ComputerVisionInnerError	Détails sur l’erreur de demande d’API.
ComputerVisionInnerErrorCodeValue	Code d’erreur.
DetectedObject	Objet détecté dans une image.
DetectResult	Résultat d’un appel DetectImage.
ImageMetadata	Métadonnées d’image.
ObjectHierarchy	Objet détecté à l’intérieur d’une image.

BoundingRect

Object

Cadre englobant d’une zone à l’intérieur d’une image.

Nom	Type	Description
h	integer (int32)	Hauteur mesurée à partir du point supérieur gauche de la zone, en pixels.
w	integer (int32)	Largeur mesurée à partir du point supérieur gauche de la zone, en pixels.
x	integer (int32)	Coordonnée X du point gauche supérieur gauche de la zone, en pixels.
y	integer (int32)	Coordonnée Y du point gauche supérieur gauche de la zone, en pixels.

ComputerVisionError

Object

Erreur de demande d’API.

Nom	Type	Description
code	ComputerVisionErrorCodes	Code d’erreur.
innererror	ComputerVisionInnerError	L’erreur interne contient des informations plus spécifiques.
message	string	Message expliquant l’erreur signalée par le service.

ComputerVisionErrorCodes

Énumération

Code d’erreur.

Valeur	Description
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable

ComputerVisionErrorResponse

Object

Réponse d’erreur de l’API.

Nom	Type	Description
error	ComputerVisionError	Contenu de l’erreur.

ComputerVisionInnerError

Object

Détails sur l’erreur de demande d’API.

Nom	Type	Description
code	ComputerVisionInnerErrorCodeValue	Code d’erreur.
message	string	Message d'erreur.

ComputerVisionInnerErrorCodeValue

Énumération

Code d’erreur.

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

DetectedObject

Object

Objet détecté dans une image.

Nom	Type	Description
confidence	number (double)	Score de confiance d’avoir observé l’objet dans l’image, sous la forme d’une valeur comprise entre 0 et 1.
object	string	Étiquette de l’objet.
parent	ObjectHierarchy	Objet parent, du point de vue de la taxonomie. L’objet parent est une forme plus générique de cet objet. Par exemple, un « bulldog » aurait un parent de « chien ».
rectangle	BoundingRect	Emplacement approximatif de l’objet détecté.

DetectResult

Object

Résultat d’un appel DetectImage.

Nom	Type	Description
metadata	ImageMetadata	Métadonnées d’image.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Version du modèle IA.
objects	DetectedObject[]	Tableau d’objets détectés.
requestId	string	ID de la demande d’API REST.

ImageMetadata

Object

Métadonnées d’image.

Nom	Type	Description
format	string	Format d’image.
height	integer (int32)	Hauteur de l’image, en pixels.
width	integer (int32)	Largeur de l’image, en pixels.

ObjectHierarchy

Object

Objet détecté à l’intérieur d’une image.

Nom	Type	Description
confidence	number (double)	Score de confiance d’avoir observé l’objet dans l’image, sous la forme d’une valeur comprise entre 0 et 1.
object	string	Étiquette de l’objet.
parent	ObjectHierarchy	Objet parent, du point de vue de la taxonomie. L’objet parent est une forme plus générique de cet objet. Par exemple, un « bulldog » aurait un parent de « chien ».