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 volto, l'API Vision può confrontare il volto con una galleria indicizzata 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 ID macchina Knowledge Graph (MID) della celebrità, il loro nome e un riquadro di delimitazione che indica dove appare il volto nell'immagine.
Richiedi 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 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 caratteristiche su un file immagine locale.
Per le richieste REST, invia i contenuti del file immagine come stringa con codifica 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 delle celebrità devi prima ottenere l'accesso
alla funzionalità per il tuo progetto e poi utilizza
Funzionalità di rilevamento facciale (enum FACE_DETECTION).
I risultati contengono informazioni sulla celebrità, se questa viene rilevata.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- BASE64_ENCODED_IMAGE: la rappresentazione base64
(stringa ASCII) dei dati immagine binari. Questa stringa dovrebbe essere simile alla
la seguente stringa:
/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.
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.
ed esegui questo comando:
$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 remota, specifica l'URL web del file o 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à 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 percorso
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.
ed esegui questo comando:
$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 desideri essere incluso in questa funzione 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.