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 è in grado di riconoscere migliaia di celebrità ed è utilizzata solo per contenuti multimediali fotografati professionali in cui è noto che celebrità comunemente riconoscibili appaiono nell'immagine.
Se viene trovata una corrispondenza, l'API Vision fornisce il ID macchina Knowledge Graph (MID) della celebrità, il suo nome e un riquadro di delimitazione che indica il punto in cui il volto compare nell'immagine.
Richiedi l'accesso all'API
Questa funzionalità è destinata ad aziende del settore dei media e all'intrattenimento o a partner approvati su contenuti multimediali di produzione professionale. Per richiedere l'accesso all'API, invia questo modulo con informazioni sulla tua azienda e sul tuo caso d'uso.
Richiedere il riconoscimento di celebrità 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 celebrità, devi prima ottenere l'accesso
alla funzionalità del progetto, quindi utilizzare la funzionalità
rilevamento dei volti esistente (FACE_DETECTION enum).
I risultati contengono informazioni sulla celebrità se viene rilevata una celebrità.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- BASE64_ENCODED_IMAGE: la rappresentazione base64 (stringa ASCII) dei dati di 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:
arricciatura
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 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 remoto, specifica l'URL web o l'URI Cloud Storage del file nel corpo della richiesta.
Per inviare una richiesta di riconoscimento di celebrità, devi prima ottenere l'accesso
alla funzionalità del progetto, quindi utilizzare la funzionalità
rilevamento dei volti esistente (FACE_DETECTION enum).
I risultati contengono informazioni sulla celebrità se viene rilevata una celebrità.
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:
arricciatura
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 delle celebrità
Se sei una celebrità e non vuoi far parte di questa funzionalità per Cloud Vision o per l'API Video Intelligence, compila e invia questo modulo.
Segnala un uso improprio
Se sospetti che la funzionalità di riconoscimento celebrità dell'API Vision venga utilizzata in qualsiasi modo, comunicacelo utilizzando questo modulo.