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à raccolte da Google.
L'API Vision può riconoscere migliaia di celebrità ed è destinada all'utilizzo solo su contenuti multimediali fotografati professionalmente in cui è noto che appaiono celebrità comunemente riconoscibili nell'immagine.
Se viene trovata una corrispondenza, l'API Vision fornisce il MID (Knowledge Graph Machine ID) della celebrità, il suo nome e un riquadro di delimitazione che indica dove si trova il volto nell'immagine.
Richiedere l'accesso API
Questa funzionalità è pensata per essere utilizzata da aziende del settore dei media e dell'intrattenimento o da partner approvati per i contenuti multimediali prodotti professionalmente. Per richiedere l'accesso alle 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 della libreria client, specifica il percorso di un'immagine locale nella 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à di rilevamento dei volti esistente (enum FACE_DETECTION).
I risultati contengono informazioni sulle celebrità se ne viene rilevata una.
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- BASE64_ENCODED_IMAGE: la rappresentazione base64 (stringa ASCII) dei dati immagine binari. Questa stringa dovrebbe essere simile alla
stringa riportata di seguito:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: l'ID del tuo 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 delle seguenti opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
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 su Cloud Storage o sul web. Per inviare una richiesta di file remoto, specifica l'URL web o l'URI Cloud Storage del file 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à di rilevamento dei volti esistente (enum FACE_DETECTION).
I risultati contengono informazioni sulle celebrità se ne viene rilevata una.
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: l'ID del tuo 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 delle seguenti opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
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 del riconoscimento delle celebrità
Se sei una celebrità e non vuoi che la tua immagine venga inclusa in questa funzionalità per l'API Cloud Vision o Video Intelligence, compila e invia questo modulo.
Segnalare un uso improprio
Se sospetti che la funzionalità di riconoscimento delle celebrità dell'API Vision sia stata usata in modo improprio, ti invitiamo a comunicarcelo utilizzando questo modulo.