Partager via


Tag Image - Tag Image

Cette opération génère une liste de mots ou de balises qui sont pertinents pour le contenu de l’image fournie. L’API Vision par ordinateur peut retourner des balises basées sur des objets, des êtres vivants, des paysages ou des actions trouvés dans des images. Contrairement aux catégories, les balises ne sont pas organisées en fonction d’un système de classification hiérarchique, mais correspondent au contenu de l’image. Les balises peuvent contenir des indicateurs pour éviter toute ambiguïté ou fournir un contexte, par exemple la balise « ascomycete » peut être accompagnée de l’indicateur « champignon ». 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/tag
POST {Endpoint}/vision/v3.2/tag?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.

language
query

string

Langage souhaité 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 pour obtenir la liste des langues prises 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

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

TagResult

Objet balises d’image.

Other Status Codes

ComputerVisionErrorResponse

Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Successful TagImage request

Exemple de requête

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/tag


{
  "url": "{url}"
}

Exemple de réponse

{
  "tags": [
    {
      "name": "grass",
      "confidence": 0.9999997615814209
    },
    {
      "name": "outdoor",
      "confidence": 0.9999706745147705
    },
    {
      "name": "sky",
      "confidence": 0.9992897510528564
    },
    {
      "name": "building",
      "confidence": 0.9964632391929626
    },
    {
      "name": "house",
      "confidence": 0.9927980303764343
    },
    {
      "name": "lawn",
      "confidence": 0.8226802945137024
    },
    {
      "name": "green",
      "confidence": 0.6412225365638733
    },
    {
      "name": "residential",
      "confidence": 0.31403225660324097
    }
  ],
  "requestId": "1ad0e45e-b7b4-4be3-8042-53be96103337",
  "metadata": {
    "width": 400,
    "height": 400,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

Définitions

Nom Description
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.

ImageMetadata

Métadonnées d’image.

ImageTag

Observation d’entité dans l’image, ainsi que le score de confiance.

ImageUrl
TagResult

Résultats d’une opération de balise d’image, y compris les balises et les 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.

Valeur Description
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

Réponse d’erreur de l’API.

Nom Type Description
error

ComputerVisionError

Contenu de l’erreur.

ComputerVisionInnerError

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

Nom Type Description
code

ComputerVisionInnerErrorCodeValue

Code d’erreur.

message

string

Message d'erreur.

ComputerVisionInnerErrorCodeValue

Code d’erreur.

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

ImageMetadata

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.

ImageTag

Observation d’entité dans l’image, ainsi que le score de confiance.

Nom Type Description
confidence

number (double)

Niveau de confiance que l’entité a été observée.

hint

string

Indicateur/détails facultatifs pour cette balise.

name

string

Nom de l’entité.

ImageUrl

Nom Type Description
url

string

URL accessible publiquement d’une image.

TagResult

Résultats d’une opération de balise d’image, y compris les balises et les métadonnées d’image.

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.

requestId

string

ID de la demande d’API REST.

tags

ImageTag[]

Liste des balises avec niveau de confiance.