Messaggi di errore

Scopri come risolvere alcuni errori generati da Speech-to-Text: In questo argomento vengono trattati gli errori le cui soluzioni richiedono 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 voce in testo potrebbe non andare a buon fine.

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

"Il file ... (puntato dalla 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

Vietato: l'API POST 403 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
    

"È necessario utilizzare l'audio a canale singolo (mono)"

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 devi dichiarare che il tuo file audio ha più canali.

"È necessario 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 ulteriori informazioni sulle codifiche supportate in Speech-to-Text, vedi consulta la guida sulle codifiche.

"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.

""config" riconoscimento non valido: codifica non valida"

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'input audio e assicurati di aver impostato correttamente il campo encoding.

"La dimensione del payload della richiesta supera 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 Google Cloud Storage (GCS) per evitare il limite di 10 MB. Consulta le delle quote e limiti per ulteriori informazioni.

"Quota superata"

Se ricevi questo messaggio:

RESOURCE_EXHAUSTED: Quota exceeded.

Hai raggiunto il limite della quota giornaliera o per minuto. Esamina il delle quote e limiti di utilizzo Speech-to-Text:

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