La funzionalità di rilevamento dei volti dell'API Video Intelligence cerca i volti in un video.
Rilevamento facciale da un file in Cloud Storage
I seguenti esempi dimostrano il rilevamento facciale su un file che si trova in di archiviazione ideale in Cloud Storage.
REST
Invia una richiesta di annotazione video
Di seguito viene illustrato come inviare una richiesta POST al
videos:annotate
. L'esempio utilizza Google Cloud CLI per creare un token di accesso. Per
istruzioni sull'installazione di gcloud CLI, consulta
Guida rapida dell'API Video Intelligence.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- INPUT_URI: un bucket Cloud Storage che contiene il file da
annotare il nome, incluso il nome del file. Deve iniziare con gs://.
Ad esempio: `"inputUri": "gs://cloud-samples-data/video/googlework_short.mp4"` - PROJECT_NUMBER: l'identificatore numerico del tuo progetto Google Cloud
Metodo HTTP e URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corpo JSON della richiesta:
{ "inputUri": "INPUT_URI", "features": ["FACE_DETECTION"] }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Se la risposta ha esito positivo, l'API Video Intelligence restituisce name
per
operativa. Quanto sopra mostra un esempio di risposta di questo tipo, in cui:
- PROJECT_NUMBER: il numero del tuo progetto
- LOCATION_ID: la regione Cloud in cui deve essere eseguita l'annotazione
posto. Le regioni cloud supportate sono:
us-east1
,us-west1
,europe-west1
,asia-east1
. Se nessuna regione è specificata, viene selezionata una regione in base alla posizione del file video. - OPERATION_ID: l'ID dell'operazione a lunga esecuzione creata
della richiesta e fornito nella risposta quando hai avviato
operativa, ad esempio
12345...
Ottieni i risultati delle annotazioni
Per recuperare il risultato dell'operazione, effettua una richiesta GET utilizzando il metodo dell'operazione restituito dalla chiamata a videos:annotate, come illustrato nell'esempio seguente.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- OPERATION_NAME: il nome dell'operazione come
restituiti dall'API Video Intelligence. Il nome dell'operazione ha il formato
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: l'identificatore numerico del tuo progetto Google Cloud
Metodo HTTP e URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Le annotazioni del rilevamento dei volti vengono restituite come elenco faceAnnotations
.
Nota: il campo done viene restituito solo quando il valore è True.
Non è incluso nelle risposte per cui l'operazione non è stata completata.
Java
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le Istruzioni per la configurazione di C# Nella pagina delle librerie client e poi visita Documentazione di riferimento di Video Intelligence per .NET.
PHP Segui le Istruzioni per la configurazione dei file PHP Nella pagina delle librerie client e poi visita Documentazione di riferimento di Video Intelligence per PHP.
Rubino: Segui le Istruzioni per la configurazione di Ruby Nella pagina delle librerie client e poi visita Documentazione di riferimento di Video Intelligence per Ruby.
Rilevamento facciale da un file locale
L'esempio seguente utilizza il rilevamento dei volti per trovare entità in un video da un file video caricato dal tuo computer locale.
REST
Invia la richiesta di processo
Per eseguire il rilevamento facciale su un file video locale, esegui la codifica in base64 dei contenuti
del file video. Per informazioni su come codificare in base64 i contenuti di un
consulta l'articolo Codifica Base64. Quindi, effettua una richiesta POST
videos:annotate
. Includi i contenuti con codifica Base64 nel campo inputContent
campo della richiesta e specifica la funzionalità FACE_DETECTION
.
Di seguito è riportato un esempio di richiesta POST mediante curl. L'esempio utilizza il parametro Google Cloud CLI per creare un token di accesso. Per istruzioni sull'installazione del con gcloud CLI, consulta Guida rapida dell'API Video Intelligence
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- inputContent: File video locale in formato binario
Ad esempio: "AAAAGGZ0eXBtcDQyAAAAAGlzb21tcDQyAAGVYW1vb3YAAABsbXZoZAAAAADWvhlR1r4ZUQABX5ABCOxo AAEAAAEAAAAAAA4..." - PROJECT_NUMBER: l'identificatore numerico del tuo progetto Google Cloud
Metodo HTTP e URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corpo JSON della richiesta:
{ inputContent: "Local video file in binary format", "features": ["FACE_DETECTION"] }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Se la richiesta ha esito positivo, Video Intelligence utilizzerà name
per la tua operazione. La
riportato sopra mostra un esempio di risposta di questo tipo, dove project-number
è il numero del progetto e operation-id
è l'ID dell'operazione a lunga esecuzione creata per la richiesta.
{
"name": "us-west1.17122464255125931980"
}
Ottieni i risultati
Per recuperare il risultato dell'operazione, effettua una richiesta GET
operations
endpoint e specificare il nome dell'operazione.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- OPERATION_NAME: il nome dell'operazione come
restituiti dall'API Video Intelligence. Il nome dell'operazione ha il formato
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: l'identificatore numerico del tuo progetto Google Cloud
Metodo HTTP e URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Java
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le Istruzioni per la configurazione di C# Nella pagina delle librerie client e poi visita Documentazione di riferimento di Video Intelligence per .NET.
PHP Segui le Istruzioni per la configurazione dei file PHP Nella pagina delle librerie client e poi visita Documentazione di riferimento di Video Intelligence per PHP.
Rubino: Segui le Istruzioni per la configurazione di Ruby Nella pagina delle librerie client e poi visita Documentazione di riferimento di Video Intelligence per Ruby.