Questa pagina descrive come attivare il riconoscimento della lingua per le richieste di trascrizione audio inviate a Cloud Speech-to-Text.
In alcune situazioni, non sai con certezza quale lingua contengono le tue registrazioni audio. Ad esempio, se pubblichi il tuo servizio, la tua app o il tuo prodotto in un paese con più lingue ufficiali, potresti ricevere input audio dagli utenti in diverse lingue. Questo può rendere molto più difficile specificare un singolo codice lingua per le richieste di trascrizione.
Riconoscimento di più lingue
Cloud Speech-to-Text ti consente di specificare un insieme di lingue alternative che i tuoi dati audio potrebbero contenere. Quando invii una richiesta di trascrizione audio a Cloud Speech-to-Text, puoi fornire un elenco di lingue aggiuntive che potrebbero essere incluse nei dati audio. Se includi un elenco di lingue nella richiesta, Cloud Speech-to-Text tenta di trascrivere l'audio in base alla lingua che meglio si adatta al campione tra le alternative fornite. Cloud Speech-to-Text etichetta quindi i risultati della trascrizione con il codice della lingua previsto.
Questa funzionalità è ideale per le app che devono trascrivere brevi istruzioni, come i comandi vocali o la ricerca. Puoi elencare fino a tre lingue alternative tra quelle supportate da Cloud Speech-to-Text, oltre alla lingua principale (per un totale di quattro lingue).
Anche se puoi specificare lingue alternative per la richiesta di trascrizione del parlato, devi comunque fornire un codice della lingua principale nel campo languageCode. Inoltre, dovresti limitare al minimo il numero di lingue che richiedi. Minore è il numero di codici di lingua alternativi richiesti, maggiore è la probabilità che Cloud Speech-to-Text selezioni quello corretto. Specificare una sola lingua produce i risultati migliori.
Attiva il riconoscimento della lingua nelle richieste di trascrizione audio
Per specificare lingue alternative nella trascrizione audio, devi impostare il campo alternativeLanguageCodes su un elenco di codici lingua nei parametri RecognitionConfig per la richiesta. Cloud STT supporta codici di lingua alternativi per tutti i metodi di riconoscimento vocale: speech:recognize, speech:longrunningrecognize e Streaming.
Utilizza un file locale
Protocollo
Per informazioni dettagliate, consulta l'endpoint API speech:recognize.
Per eseguire il riconoscimento vocale sincrono, effettua una richiesta POST e fornisci il corpo della richiesta appropriato. Di seguito è riportato un esempio di richiesta POST mediante curl. L'esempio utilizza Google Cloud CLI per generare un token di accesso. Per istruzioni sull'installazione di gcloud CLI, consulta la guida rapida.
L'esempio seguente mostra come richiedere la trascrizione di un file audio che potrebbe includere parlato in inglese, francese o tedesco.
curl -s -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ https://speech.googleapis.com/v1p1beta1/speech:recognize \ --data '{ "config": { "encoding": "LINEAR16", "languageCode": "en-US", "alternativeLanguageCodes": ["fr-FR", "de-DE"], "model": "command_and_search" }, "audio": { "uri": "gs://cloud-samples-tests/speech/commercial_mono.wav" } }' > multi-language.txt
Se la richiesta va a buon fine, il server restituisce un codice di stato HTTP 200 OK e la risposta in formato JSON, salvata in un file denominato multi-language.txt.
{
"results": [
{
"alternatives": [
{
"transcript": "hi I'd like to buy a Chromecast I'm ..."
"confidence": 0.9466864
}
],
"languageCode": "en-us"
},
{
"alternatives": [
{
"transcript": " let's go with the black one",
"confidence": 0.9829583
}
],
"languageCode": "en-us"
},
]
}
Java
Per scoprire come installare e utilizzare la libreria client per Cloud STT, consulta Librerie client di Cloud STT. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud STT Java.
Per eseguire l'autenticazione in Cloud STT, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Cloud STT, consulta Librerie client di Cloud STT. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud STT Node.js.
Per eseguire l'autenticazione in Cloud STT, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Cloud STT, consulta Librerie client di Cloud STT. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud STT Python.
Per eseguire l'autenticazione in Cloud STT, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Utilizza un file remoto
Java
Per scoprire come installare e utilizzare la libreria client per Cloud STT, consulta Librerie client di Cloud STT. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud STT Java.
Per eseguire l'autenticazione in Cloud STT, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Cloud STT, consulta Librerie client di Cloud STT. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud STT Node.js.
Per eseguire l'autenticazione in Cloud STT, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Cloud STT, consulta Librerie client di Cloud STT. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud STT Python.
Per eseguire l'autenticazione in Cloud STT, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.