In questa pagina viene descritto come riconoscere le celebrità nelle immagini utilizzando API Vision.
L'API Vision 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 riconosce migliaia di celebrità ed è destinato all'utilizzo solo su contenuti multimediali fotografati professionali dove comunemente noti per comparire 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 accesso API
Questa funzionalità è destinata all'uso da parte di contenuti multimediali e società di intrattenimento o partner approvati su contenuti multimediali prodotti da professionisti. Per richiedere l'API per l'accesso, invia questo modulo informazioni sulla tua azienda e sul tuo caso d'uso.
Richiedi il riconoscimento di celebrità 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 nel tuo
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: il base64
(stringa ASCII) dei dati dell'immagine binaria. 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:
Richiedi il riconoscimento di celebrità per un'immagine remota
Puoi utilizzare l'API Vision per eseguire il rilevamento delle caratteristiche su un file immagine remoto che si trova in 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 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:
- 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.
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:
Richiedi la disattivazione della 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.
Segnala uso improprio
Se sospetti che la funzionalità di riconoscimento delle celebrità dell'API Vision sia stata utilizzato in qualsiasi modo, faccelo sapere utilizzando questo modulo.