Questa pagina descrive come riconoscere le celebrità nelle immagini utilizzando l'API Vision.
L'API Vision ti consente di rilevare i volti in un'immagine. Quando riconosce un volto, l'API Vision può confrontarlo con una galleria indicizzata di celebrità compilata da Google.
L'API Vision può riconoscere migliaia di celebrità ed è destinata all'uso solo su contenuti multimediali fotografati professionalmente in cui è noto che compaiono celebrità comunemente riconoscibili nell'immagine.
Se viene trovata una corrispondenza, l'API Vision fornisce l'ID macchina Knowledge Graph (MID) della celebrità, il suo nome e un riquadro di delimitazione che indica dove appare il volto nell'immagine.
Richiedere l'accesso API
Questa funzionalità è destinata all'uso da parte di società di media e intrattenimento o partner approvati per contenuti multimediali prodotti professionalmente. Per richiedere l'accesso all'API, invia questo modulo con informazioni sulla tua azienda e sul tuo caso d'uso.
Richiedere il riconoscimento di volti celebri per un'immagine locale
Puoi utilizzare l'API Vision per eseguire il rilevamento delle funzionalità su un file immagine locale.
Per le richieste REST, invia i contenuti del file immagine come stringa codificata in base64 nel corpo della richiesta.
Per le richieste gcloud e delle librerie client, specifica il percorso di un'immagine locale nella tua richiesta.
Per inviare una richiesta di riconoscimento di volti celebri, devi prima ottenere l'accesso
alla funzionalità per il tuo progetto e poi utilizzare la funzionalità
rilevamento dei volti esistente (enumerazione FACE_DETECTION).
Se viene rilevata una celebrità, i risultati contengono informazioni su di lei.
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- BASE64_ENCODED_IMAGE: la rappresentazione in Base64 (stringa ASCII) dei dati dell'immagine binaria. Questa stringa dovrebbe essere simile alla
seguente:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: il tuo ID progetto Google Cloud .
Metodo HTTP e URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corpo JSON della richiesta:
{
"requests": [
{
"image": {
"content": "BASE64_ENCODED_IMAGE"
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
ed esegui questo comando:
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
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$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
Dovresti ricevere una risposta JSON simile alla seguente:
Richiedere il riconoscimento di volti celebri per un'immagine remota
Puoi utilizzare l'API Vision per eseguire il rilevamento delle funzionalità su un file immagine remoto che si trova in Cloud Storage o sul web. Per inviare una richiesta di file remoto, specifica l'URL web del file o l'URI Cloud Storage nel corpo della richiesta.
Per inviare una richiesta di riconoscimento di volti celebri, devi prima ottenere l'accesso
alla funzionalità per il tuo progetto e poi utilizzare la funzionalità
rilevamento dei volti esistente (enumerazione FACE_DETECTION).
Se viene rilevata una celebrità, i risultati contengono informazioni su di lei.
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- CLOUD_STORAGE_IMAGE_URI: il percorso di un file immagine valido in un bucket Cloud Storage. Devi disporre almeno dei privilegi di lettura per il file.
Esempio:
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID: il tuo ID progetto Google Cloud .
Metodo HTTP e URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corpo JSON della richiesta:
{
"requests": [
{
"image": {
"source": {
"imageUri": "CLOUD_STORAGE_FILE_URI"
}
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
ed esegui questo comando:
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
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$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
Dovresti ricevere una risposta JSON simile alla seguente:
Richiedere la disattivazione per le celebrità
Se sei una celebrità e non vuoi essere inclusa in questa funzionalità per l'API Cloud Vision o Video Intelligence, compila e invia questo modulo.
Segnala un uso improprio
Se sospetti che la funzionalità Riconoscimento di volti celebri dell'API Vision venga utilizzata in modo improprio, comunicacelo utilizzando questo modulo.