L'API Video Intelligence può identificare le entità mostrate nei filmati video utilizzando LABEL_DETECTION funzionalità. Questa funzionalità identifica oggetti, luoghi, attività, specie animali, prodotti e altro ancora.
L'analisi può essere suddivisa:
- A livello di frame:
Le entità vengono identificate ed etichettate all'interno di ogni frame (con un campionamento di un frame al secondo). - Livello di inquadratura:
scatti vengono rilevati automaticamente in ogni segmento (o un video). Le entità vengono quindi identificate ed etichettate all'interno di ogni scatto. - Livello di segmento:
è possibile specificare i segmenti di un video selezionati dall'utente per l'analisi mediante la definizione di compensazioni ora di inizio e fine ai fini dell'analisi di annotazione (vedi VideoSegment). Le entità vengono quindi identificate ed etichettate all'interno di ciascun segmento. Se non esistono segmenti vengono specificati, l'intero video viene considerato come un unico segmento.
Annota un file locale
Ecco un esempio di analisi video delle etichette in un file locale.
Vuoi saperne di più? Consulta il nostro dettagliato Python Google Cloud.
REST
Invia la richiesta di processo
Di seguito viene illustrato come inviare una richiesta POST
all'indirizzo
videos:annotate
. Puoi configurare
LabelDetectionMode
alle annotazioni a livello di inquadratura e/o a livello di fotogramma. È consigliabile utilizzare
SHOT_AND_FRAME_MODE
. L'esempio utilizza il token di accesso per
con un account di servizio configurato per il progetto utilizzando Google Cloud CLI. Per
Istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un servizio
di accesso all'account e ottenere un token di accesso, consulta
Guida rapida di Video Intelligence.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- BASE64_ENCODED_CONTENT: il tuo video come base64 codificati. Consulta le istruzioni su come converti i dati in base64.
- 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": "BASE64_ENCODED_CONTENT", "features": ["LABEL_DETECTION"], }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" }
Se la richiesta ha esito positivo, Video Intelligence restituisce il nome dell'operazione.
Ottieni i risultati
Per ottenere i risultati della tua richiesta, devi inviare una richiesta GET
a
il projects.locations.operations
risorsa. Di seguito viene illustrato come inviare questa richiesta.
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:
Go
Java
Node.js
Python
Per ulteriori informazioni sull'installazione e sull'utilizzo della libreria client dell'API Video Intelligence per Python, consulta le librerie client dell'API Video Intelligence.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.
Annota un file su Cloud Storage
Ecco un esempio di esecuzione di analisi video per etichette su un file in Cloud Storage.
REST
Per ulteriori informazioni sull'installazione e sull'utilizzo della libreria client dell'API Video Intelligence per Python, consulta le librerie client dell'API Video Intelligence.Invia la richiesta di processo
Di seguito viene illustrato come inviare una richiesta POST
all'indirizzo
annotate
. L'esempio utilizza il token di accesso per
con un account di servizio configurato per il progetto utilizzando Google Cloud CLI. Per
Istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un servizio
di accesso all'account e ottenere un token di accesso, consulta
Guida rapida di Video Intelligence.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- INPUT_URI: un bucket Cloud Storage che contiene
al file a cui vuoi aggiungere un'annotazione, incluso il nome. Deve
iniziano con
gs://
. - 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": ["LABEL_DETECTION"], }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" }
Se la richiesta ha esito positivo, Video Intelligence restituisce il nome dell'operazione.
Ottieni i risultati
Per ottenere i risultati della tua richiesta, devi inviare una richiesta GET
a
il projects.locations.operations
risorsa. Di seguito viene illustrato come inviare questa richiesta.
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:
Scarica i risultati delle annotazioni
Copia l'annotazione dall'origine al bucket di destinazione: (vedi Copiare file e oggetti)
gsutil cp gcs_uri gs://my-bucket
Nota: se l'URI GCS di output è fornito dall'utente, l'annotazione viene archiviata nell'URI GCS.
Go
Java
Node.js
Python
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.