Messaggi di errore

Questa pagina descrive gli errori di Cloud Speech-to-Text la cui risoluzione richiede più passaggi di quelli che possono essere 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.

Cloud STT utilizza le credenziali predefinite dell'applicazione (ADC) per l'autenticazione.

Le credenziali per ADC devono essere disponibili nel contesto in cui chiami l'API Cloud 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 Cloud STT potrebbe non andare a buon fine.

Per scoprire come fornire le credenziali a Credenziali predefinite dell'applicazione, consulta Configurare le credenziali predefinite dell'applicazione.

"Il file ... (indicato 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 punti alla posizione corretta.

Per diagnosticare questo errore, prova ad aprire il file delle chiavi del account di servizio dalla cartella da cui stai tentando di chiamare l'API Cloud Speech-to-Text.

cat $GOOGLE_APPLICATION_CREDENTIALS

Vietato: 403 POST API non è stata utilizzata o è disabilitata

Se ricevi il messaggio: 

Forbidden: 403 POST Cloud Speech-to-Text API has not been used in
project # before or it is disabled.
Enable it by visiting [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 Cloud STT. 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 del account di servizio dalla cartella da cui stai tentando di chiamare l'API Cloud Speech-to-Text.
cat $GOOGLE_APPLICATION_CREDENTIALS

"Deve utilizzare l'audio a un solo canale (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 file audio, devi dichiarare che l'audio ha più canali.

"Must use 16 bit samples for LINEAR_PCM" (Devono essere utilizzati 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 Cloud STT, consulta la guida alle codifiche.

"Sync input too long" (Sincronizzazione input troppo lungo)

Se ricevi questo messaggio:

Sync input too long. For audio longer than 1 min use
LongRunningRecognize with a 'uri' parameter.

Il metodo synchronous recognize per Cloud STT supporta solo la trascrizione di dati audio di durata massima di 1 minuto. Per dati audio più lunghi, utilizza asynchronous recognize.

"Invalid recognition 'config': bad encoding" (Riconoscimento non valido "config": codifica errata)

Se ricevi questo messaggio:

Invalid recognition 'config': bad encoding.

I dati audio potrebbero non essere codificati correttamente o sono codificati con un codec diverso da quello dichiarato nel 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 10 MB per una singola richiesta inviata all'API utilizzando un file locale. Puoi spostare il file audio in un bucket Cloud Storage per evitare il limite di 10 MB. Per saperne di più, consulta la pagina Quote e limiti.

"Quota superata"

Se ricevi questo messaggio:

RESOURCE_EXHAUSTED: Quota exceeded.

Hai raggiunto il limite della tua quota al minuto o giornaliera. Esamina le quote e i limiti per l'utilizzo di Cloud STT.

Puoi richiedere l'incremento delle tue quote dalla Google Cloud console.