Trascrivere il parlato in testo utilizzando l'API

Prima di iniziare

Prima di poter inviare una richiesta all'API Speech-to-Text, devi aver completato le seguenti azioni. Per informazioni dettagliate, consulta la pagina Prima di iniziare.

• Attivare Speech-to-Text in un progetto Google Cloud.
  1. Assicurati che la fatturazione sia attivata per Speech-to-Text.

• Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

• (Facoltativo) Crea un nuovo bucket Google Cloud Storage per archiviare i dati audio.

Esecuzione di una richiesta di trascrizione audio

Ora puoi utilizzare Speech-to-Text per trascrivere un file audio in testo. Utilizza il seguente esempio di codice per inviare una richiesta REST recognize all'API Speech-to-Text.

1. Crea un file di richiesta JSON con il testo seguente e salvalo come sync-request.json file di testo normale:

   {
     "config": {
         "encoding":"FLAC",
         "sampleRateHertz": 16000,
         "languageCode": "en-US",
         "enableWordTimeOffsets": false
     },
     "audio": {
         "uri":"gs://cloud-samples-tests/speech/brooklyn.flac"
     }
   }
     

   Questo snippet JSON indica che il file audio ha un formato di codifica FLAC, una frequenza di campionamento di 16000 Hz e che il file audio è archiviato su Google Cloud Storage all'URI specificato. Il file audio è accessibile al pubblico, quindi non hai bisogno di credenziali di autenticazione per accedervi.

2. Utilizza curl per inviare una richiesta speech:recognize, passando il nome del file della richiesta JSON configurata nel passaggio 1:

   Il comando curl di esempio utilizza il comando gcloud auth print-access-token per ottenere un token di autenticazione.

   curl -s -H "Content-Type: application/json" \
       -H "Authorization: Bearer "$(gcloud auth print-access-token) \
       https://speech.googleapis.com/v1/speech:recognize \
       -d @sync-request.json
     

   Tieni presente che per passare un nome file a curl devi utilizzare l'opzione -d (per "data") e precedere il nome file con il segno @. Questo file deve trovarsi nella stessa directory in cui esegui il comando curl.

   Dovresti visualizzare una risposta simile alla seguente:

   {
     "results": [
       {
         "alternatives": [
           {
             "transcript": "how old is the Brooklyn Bridge",
             "confidence": 0.98267895
           }
         ]
       }
     ]
   }
     

Complimenti! Hai inviato la tua prima richiesta a Speech-to-Text.

Se ricevi un errore o una risposta vuota da Speech-to-Text, consulta i passaggi per la risoluzione dei problemi e la mitigazione degli errori.