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 |
Objet balises d’image. |
|
Other Status Codes |
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 |
---|---|
Computer |
Erreur de demande d’API. |
Computer |
Code d’erreur. |
Computer |
Réponse d’erreur de l’API. |
Computer |
Détails sur l’erreur de demande d’API. |
Computer |
Code d’erreur. |
Image |
Métadonnées d’image. |
Image |
Observation d’entité dans l’image, ainsi que le score de confiance. |
Image |
|
Tag |
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 |
Code d’erreur. |
|
innererror |
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 |
Contenu de l’erreur. |
ComputerVisionInnerError
Détails sur l’erreur de demande d’API.
Nom | Type | Description |
---|---|---|
code |
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 |
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 |
Image |
Liste des balises avec niveau de confiance. |