Cette page explique comment reconnaître des célébrités dans des images à l'aide de l'API Vision.
L'API Vision vous permet de détecter les visages dans une image. Lorsqu'elle reconnaît un visage, l'API Vision peut le comparer à une galerie indexée de célébrités rassemblées par Google.
L'API Vision peut reconnaître des milliers de célébrités. Elle ne doit être utilisée que sur du contenu multimédia photographié par des photographes professionnels où des célébrités communément reconnaissables apparaissent dans l'image.
En cas de correspondance, l'API Vision fournit l'identifiant de machine Knowledge Graph (MID) de la célébrité, son nom et un cadre de délimitation indiquant où le visage apparaît sur l'image.
Demander l'accès à l'API
Cette fonctionnalité est destinée aux entreprises du secteur du multimédia et du divertissement ou aux partenaires agréés qui utilisent du contenu multimédia produit par des professionnels. Pour demander l'accès à l'API, veuillez nous envoyer ce formulaire contenant des informations sur votre entreprise et votre cas d'utilisation.
Demander l'identification de célébrités pour une image locale
L'API Vision permet de détecter des caractéristiques dans un fichier image local.
Pour les requêtes REST, envoyez le contenu du fichier image en tant que chaîne encodée en base64 dans le corps de votre requête.
Pour les requêtes gcloud et les bibliothèques clientes, spécifiez le chemin d'accès à une image locale dans votre requête.
Pour envoyer une demande d'identification de célébrité, vous devez d'abord obtenir un accès à la fonctionnalité pour votre projet. Utilisez ensuite la fonctionnalité de détection des visages existante (FACE_DETECTION enum).
Les résultats contiennent des informations sur les célébrités si une célébrité est détectée.
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- BASE64_ENCODED_IMAGE : représentation en base64 (chaîne ASCII) de vos données d'image binaires. Cette chaîne doit ressembler à la chaîne suivante :
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID : ID de votre projet Google Cloud.
Méthode HTTP et URL :
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corps JSON de la requête :
{
"requests": [
{
"image": {
"content": "BASE64_ENCODED_IMAGE"
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1p4beta1/images:annotate"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Demander l'identification de célébrités pour une image distante
L'API Vision permet de détecter des caractéristiques dans un fichier image distant situé dans Cloud Storage ou sur le Web. Pour envoyer une requête de fichier distant, spécifiez l'URL Web ou l'URI Cloud Storage du fichier dans le corps de la requête.
Pour envoyer une demande d'identification de célébrité, vous devez d'abord obtenir un accès à la fonctionnalité pour votre projet. Utilisez ensuite la fonctionnalité de détection des visages existante (FACE_DETECTION enum).
Les résultats contiennent des informations sur les célébrités si une célébrité est détectée.
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- CLOUD_STORAGE_IMAGE_URI : chemin d'accès à un fichier image valide dans un bucket Cloud Storage. Il faut au minimum disposer des droits en lecture sur le fichier.
Exemple :
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID : ID de votre projet Google Cloud.
Méthode HTTP et URL :
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corps JSON de la requête :
{
"requests": [
{
"image": {
"source": {
"imageUri": "CLOUD_STORAGE_FILE_URI"
}
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1p4beta1/images:annotate"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Demander la désactivation des célébrités
Si vous êtes une célébrité et que vous ne souhaitez pas participer à cette fonctionnalité de l'API Cloud Vision ou Video Intelligence, veuillez remplir et envoyer ce formulaire.
Signaler un usage abusif
Si vous pensez que la fonctionnalité d'identification de célébrité de l'API Cloud Vision est utilisée de manière inappropriée, veuillez nous en informer en utilisant ce formulaire.