Scopri come risolvere alcuni errori generati da Speech-to-Text. In questo argomento vengono descritti gli errori le cui risoluzioni richiedono più passaggi rispetto a quelli che possono essere facilmente descritti in un messaggio di errore.
"Le credenziali predefinite dell'applicazione non sono disponibili"
Se viene visualizzato questo messaggio:
The Application Default Credentials are not available. They are available if running in Google Compute Engine. Otherwise, the environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined pointing to a file defining the credentials. See https://developers.google.com/accounts/docs/application-default-credentials for more information.
Speech-to-Text utilizza le Credenziali predefinite dell'applicazione (ADC) per l'autenticazione.
Le credenziali per ADC devono essere disponibili nel contesto che chiami l'API Speech-to-Text. Ad esempio, se configuri ADC nel terminale ma esegui il codice nel debugger dell'IDE, il contesto di esecuzione del codice potrebbe non avere accesso alle credenziali. In questo caso, la tua richiesta a Speech-to-Text potrebbe non riuscire.
Per scoprire come fornire le credenziali ad ADC, vedi Configurare le credenziali predefinite dell'applicazione.
"Il file ... (a cui punta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS) non esiste."
Se viene visualizzato questo messaggio:
ERROR: (gcloud.auth.application-default.print-access-token) File /path/to/key.json
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
"error": {
"code": 403,
"message": "The request is missing a valid API key.",
"status": "PERMISSION_DENIED"
}
}
Verifica di disporre di un file JSON della chiave dell'account di servizio valido nella posizione archiviata nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS e che la variabile rimandi alla posizione corretta.
Per diagnosticare questo errore, prova ad aprire il file della chiave dell'account di servizio dalla cartella da cui stai tentando di chiamare l'API Speech-to-Text.
cat $GOOGLE_APPLICATION_CREDENTIALS
Vietato: l'API 403 POST non è stata utilizzata o è disabilitata
Se ricevi questo messaggio:
Forbidden: 403 POST Speech-to-Text API has not been used in project # before or it is disabled. Enable it by visitng [url] then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.
- Visita il link specificato nel messaggio di errore e abilita l'API Speech-to-Text. Attendi alcuni minuti e riprova.
- Verifica di avere un file JSON della chiave dell'account di servizio valido archiviato nella variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS. Per diagnosticare questo errore, prova ad aprire il file della chiave dell'account di servizio dalla cartella da cui stai tentando di chiamare l'API Speech-to-Text.cat $GOOGLE_APPLICATION_CREDENTIALS
"Devi utilizzare l'audio a canale singolo (mono)"
Se viene visualizzato questo messaggio:
Must use single channel (mono) audio, but WAV header indicates 2 channels.
Il file audio contiene più di un canale. Per trascrivere questo file audio, devi dichiarare che l'audio ha più canali.
"Devi utilizzare campioni a 16 bit per LINEAR_PCM"
Se viene visualizzato questo messaggio:
INVALID_ARGUMENT: Must use 16 bit samples for LINEAR_PCM, but the WAV header indicates 8 bits per sample
Potresti dover modificare la codifica che hai specificato in RecognitionConfig.
Per ulteriori informazioni sulle codifiche supportate in Speech-to-Text, consulta la guida alle codificamenti.
"Input sincronizzazione troppo lungo"
Se viene visualizzato questo messaggio:
Sync input too long. For audio longer than 1 min use LongRunningRecognize with a 'uri' parameter.
Il metodo di riconoscimento sincrono per Speech-to-Text supporta solo la trascrizione di dati audio della durata massima di 1 minuto. Per dati audio più lunghi, usa invece il riconoscimento asincrono.
"Riconoscimento non valido 'config': codifica errata"
Se viene visualizzato questo messaggio:
Invalid recognition 'config': bad encoding.
I tuoi dati audio potrebbero non essere codificati correttamente oppure potrebbero essere codificati con un
codec diverso da quello che hai dichiarato in
RecognitionConfig. Controlla l'input audio e assicurati di aver impostato correttamente il campo encoding.
"Le dimensioni del payload della richiesta superano il limite"
Se ricevi uno di questi messaggi:
Request payload size exceeds the limit.
Inline audio exceeds duration limit. Please use a GCS URI.
Hai superato il limite di 10 MB per le dimensioni di una singola richiesta inviata all'API utilizzando un file locale. Puoi spostare il file audio in un bucket Google Cloud Storage (GCS) per evitare il limite di 10 MB. Consulta la pagina Quote e limiti per ulteriori informazioni.
"Quota superata"
Se viene visualizzato questo messaggio:
RESOURCE_EXHAUSTED: Quota exceeded.
Hai raggiunto il limite della quota al minuto o giornaliera. Consulta quote e limiti per l'utilizzo di Speech-to-Text.
Puoi richiedere l'aumento delle quote dalla console Google Cloud.