Messaggi di errore

Scopri come risolvere alcuni errori rilevati da Speech-to-Text. Questo argomento illustra gli errori la cui risoluzione richiede più passaggi di quelli che possono essere facilmente descritti in un messaggio di errore.

"Le credenziali predefinite dell'applicazione non sono disponibili"

Se ricevi 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 l'ADC devono essere disponibili nel contesto in cui chiami l'API Speech-to-Text. Ad esempio, se configuri l'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 di conversione di Speech-to-Text potrebbe non andare a buon fine.

Per scoprire come fornire le credenziali all'ADC, consulta Configurare le credenziali predefinite dell'applicazione.

"File ... (a cui fa riferimento la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS) non esiste!"

Se ricevi 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 avere un file JSON della chiave dell'account di servizio valido nella posizione memorizzata nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS e che la variabile indichi la posizione corretta.

Per diagnosticare questo errore, prova ad aprire il file della chiave dell'account di servizio dalla la cartella da cui stai tentando di chiamare l'API Speech-to-Text.

cat $GOOGLE_APPLICATION_CREDENTIALS

Non consentito: 403 L'API POST non è stata utilizzata o è disabilitata

Se ricevi il 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.

  1. Visita il link specificato nel messaggio di errore e abilita l'API Speech-to-Text. Attendi alcuni minuti e riprova.
  2. 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 la cartella da cui stai tentando di chiamare l'API Speech-to-Text.
    cat $GOOGLE_APPLICATION_CREDENTIALS
    

"Deve essere utilizzato l'audio mono a un canale"

Se ricevi 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 ricevi questo messaggio:

INVALID_ARGUMENT: Must use 16 bit samples for LINEAR_PCM, but the WAV
header indicates 8 bits per sample

Potrebbe essere necessario modificare la codifica specificata nel RecognitionConfig. Per informazioni sulle codifiche supportate in Speech-to-Text, consulta la guida sulle codificazioni.

"Input di sincronizzazione troppo lungo"

Se ricevi 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 la trascrizione di dati audio di durata massima di 1 minuto. Per dati audio più lunghi, utilizza invece il riconoscimento asincrono.

"Configurazione di riconoscimento non valida: codifica errata"

Se ricevi questo messaggio:

Invalid recognition 'config': bad encoding.

I dati audio potrebbero non essere codificati correttamente o essere codificati con un codec diverso da quello dichiarato in RecognitionConfig. Controlla l'ingresso 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 dimensioni di 10 MB per 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. Per ulteriori informazioni, consulta la pagina Quote e limiti.

"Quota superata"

Se ricevi questo messaggio:

RESOURCE_EXHAUSTED: Quota exceeded.

Hai raggiunto il limite della quota giornaliera o per minuto. Esamina le quote e i limiti per l'utilizzo di Speech-to-Text.

Puoi richiedere l'incremento delle tue quote da Google Cloud Console.