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

Référence

Service:: Azure AI Services

Version d'API:: 3.2

Cette opération reconnaît le contenu au sein d’une image en appliquant un modèle spécifique à un domaine. La liste des modèles spécifiques à un domaine pris en charge par l’API Vision par ordinateur peut être récupérée à l’aide de la requête GET /models. Actuellement, l’API fournit les modèles propres au domaine suivants : célébrités, des points de repère. Deux méthodes d’entrée sont prises en charge : (1) Chargement d’une image ou (2) spécification d’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/models/{model}/analyze

Avec des paramètres facultatifs:

POST {Endpoint}/vision/v3.2/models/{model}/analyze?overload=stream&language={language}&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	path	True	string	Contenu spécifique au domaine à reconnaître.
language	query		string	Langue souhaitée pour la génération de sortie. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ». Consultez https://aka.ms/cv-languages la liste des langues prises en charge.
model-version	query		string	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 ». Modèle d’expression régulière: `^(latest\|\d{4}-\d{2}-\d{2})(-preview)?$`

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	Flux d’images.

Réponses

Nom	Type	Description
200 OK	DomainModelResults	Résultat de l’analyse basé sur le modèle de domaine.
Other Status Codes	ComputerVisionErrorResponse	Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Successful AnalyzeImageByDomain request

Exemple de requête

HTTP

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


"{binary}"

Exemple de réponse

Code d’état:: 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
      }
    ]
  }
}

Définitions

Nom	Description
ComputerVisionError	Erreur de demande d’API.
ComputerVisionErrorCodes	Code d'erreur.
ComputerVisionErrorResponse	Réponse d’erreur d’API.
ComputerVisionInnerError	Détails sur l’erreur de requête d’API.
ComputerVisionInnerErrorCodeValue	Code d'erreur.
DomainModelResults	Résultat de l’analyse d’image à l’aide d’un modèle de domaine spécifique incluant des métadonnées supplémentaires.
ImageMetadata	Métadonnées d’image.

ComputerVisionError

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

Code d'erreur.

Nom	Type	Description
InternalServerError	string
InvalidArgument	string
InvalidRequest	string
ServiceUnavailable	string

ComputerVisionErrorResponse

Réponse d’erreur d’API.

Nom	Type	Description
error	ComputerVisionError	Contenu de l’erreur.

ComputerVisionInnerError

Détails sur l’erreur de requête d’API.

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

ComputerVisionInnerErrorCodeValue