Partager via


Analyze Image By Domain - Analyze Image By Domain

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 dans JSON. Si la demande a échoué, la réponse contiendra un code d’erreur et un message pour vous aider à comprendre ce qui s’est passé.

POST {Endpoint}/vision/v3.2/models/{model}/analyze
POST {Endpoint}/vision/v3.2/models/{model}/analyze?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 : « 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

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

string

Corps de la demande

Nom Obligatoire Type Description
url True

string

URL accessible publiquement d’une image.

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

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


{
  "url": "{url}"
}

Exemple de réponse

{
  "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 requête d’API.

ComputerVisionErrorCodes

Code d'erreur.

ComputerVisionErrorResponse

Réponse d’erreur de l’API.

ComputerVisionInnerError

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

ComputerVisionInnerErrorCodeValue

Code d'erreur.

DomainModelResults

Résultat de l’analyse d’images à l’aide d’un modèle de domaine spécifique incluant des métadonnées supplémentaires.

ImageMetadata

Métadonnées d’image.

ImageUrl

ComputerVisionError

Erreur de requête 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 de l’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

Code d'erreur.

Nom 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

DomainModelResults

Résultat de l’analyse d’images à l’aide d’un modèle de domaine spécifique incluant des métadonnées supplémentaires.

Nom Type Description
metadata

ImageMetadata

Métadonnées d’image.

modelVersion

string

Version du modèle IA.

requestId

string

ID de la demande d’API REST.

ImageMetadata

Métadonnées d’image.

Nom Type Description
format

string

Format d’image.

height

integer

Hauteur de l’image, en pixels.

width

integer

Largeur de l’image, en pixels.

ImageUrl

Nom Type Description
url

string

URL accessible publiquement d’une image.