L'API Video Intelligence trascrive la voce in testo dai file video supportati. Sono disponibili due modelli supportati: "default" e "video".
Richiedere la trascrizione della voce per un video
REST
Inviare la richiesta di elaborazione
Di seguito viene illustrato come inviare una richiesta POST al metodo
videos:annotate.
L'esempio utilizza il token di accesso per 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 account di
servizio e sul recupero di un token di accesso, consulta la
guida rapida di Video Intelligence.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- INPUT_URI: un bucket Cloud Storage che contiene
il file che vuoi annotare, incluso il nome del file. Deve
iniziare con
gs://.
Ad esempio:"inputUri": "gs://cloud-videointelligence-demo/assistant.mp4", - LANGUAGE_CODE: [facoltativo] consulta le lingue supportate
- PROJECT_NUMBER: l'identificatore numerico del tuo Google Cloud progetto
Metodo HTTP e URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corpo JSON della richiesta:
{
"inputUri": "INPUT_URI",
"features": ["SPEECH_TRANSCRIPTION"],
"videoContext": {
"speechTranscriptionConfig": {
"languageCode": "LANGUAGE_CODE",
"enableAutomaticPunctuation": true,
"filterProfanity": true
}
}
}
Per inviare la richiesta, espandi una di queste 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 name per l'operazione. L'esempio precedente mostra una risposta di questo tipo, in cui project-number è il numero del tuo progetto e operation-id è l'ID dell'operazione a lunga esecuzione creata per la richiesta.
Ottenere i risultati
Per ottenere i risultati della richiesta, devi inviare una richiesta GET utilizzando il nome dell'operazione restituito dalla chiamata a videos:annotate, come mostrato nell'esempio seguente.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- OPERATION_NAME: il nome dell'operazione restituito 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 Google Cloud progetto
Metodo HTTP e URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Scaricare i risultati delle annotazioni
Copia l'annotazione dall'origine al bucket di destinazione: (vedi Copiare file e oggetti)
gcloud storage cp gcs_uri gs://my-bucket
Nota: se l'URI GCS di output viene fornito dall'utente, l'annotazione viene archiviata in quell'URI GCS.
Go
Per eseguire l'autenticazione in Video Intelligence, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Video Intelligence, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Video Intelligence, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Video Intelligence, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: segui le istruzioni di configurazione di C# nella pagina delle librerie client, poi consulta la documentazione di riferimento di Video Intelligence per .NET.
PHP: segui le istruzioni di configurazione di PHP nella pagina delle librerie client, poi consulta la documentazione di riferimento di Video Intelligence per PHP.
Ruby: segui le istruzioni di configurazione di Ruby nella pagina delle librerie client, poi consulta la documentazione di riferimento di Video Intelligence per Ruby.