Tag Image - Tag Image

Service:

Azure AI Services

Version d'API:

3.2

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

Avec des paramètres facultatifs:

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

HTTP

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


{
  "url": "{url}"
}

Exemple de réponse

Code d’état:

200

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

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
InternalServerError
InvalidArgument
InvalidRequest
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
BadArgument
CancelledRequest
DetectFaceError
FailedToProcess
InternalServerError
InvalidDetails
InvalidImageFormat
InvalidImageSize
InvalidImageUrl
InvalidModel
InvalidThumbnailSize
NotSupportedFeature
NotSupportedImage
NotSupportedLanguage
NotSupportedVisualFeature
StorageException
Timeout
Unspecified
UnsupportedMediaType

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.

ImageTag

Object

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

Object

Nom	Type	Description
url	string	URL accessible publiquement d’une image.

TagResult

Object

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.