Questa pagina descrive come riconoscere le celebrità nelle immagini utilizzando l'API Vision.
L'API Vision 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 è destinata all'utilizzo solo su contenuti multimediali fotografati a livello professionale in cui nell'immagine sono note celebrità comunemente riconosciute.
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.
Richiedi accesso API
Questa funzionalità è destinata all'utilizzo da parte di società di media e intrattenimento o partner approvati su contenuti multimediali prodotti da professionisti. Per richiedere l'accesso all'API, invia questo modulo con informazioni sulla tua azienda e sul 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 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 delle celebrità, devi prima ottenere l'accesso alla funzionalità per il tuo progetto, quindi utilizzare la funzionalità di rilevamento facciale esistente (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 dell'immagine binaria. Questa stringa dovrebbe essere simile alla 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 funzionalità 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 o l'URI Cloud Storage del file nel corpo della richiesta.
Per inviare una richiesta di riconoscimento delle celebrità, devi prima ottenere l'accesso alla funzionalità per il tuo progetto, quindi utilizzare la funzionalità di rilevamento facciale esistente (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 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 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 vuoi non essere incluso in questa funzionalità per Cloud Vision o per l'API Video Intelligence, compila e invia questo modulo.
Segnala uso improprio
Se sospetti che la funzionalità di riconoscimento delle celebrità dell'API Vision sia stata utilizzata in modo improprio in qualsiasi modo, comunicacelo utilizzando questo modulo.