Create an API Key

Controlla i miei progressi

/ 30

Call the Speech API and save the result

Controlla i miei progressi

/ 70

Questo lab potrebbe incorporare strumenti di AI a supporto del tuo apprendimento.

Questi contenuti non sono ancora ottimizzati per i dispositivi mobili.

Per un'esperienza ottimale, visualizza il sito su un computer utilizzando un link inviato via email.

GSP119

Panoramica

L'API Speech-to-Text consente di integrare facilmente le tecnologie di riconoscimento vocale di Google nelle applicazioni degli sviluppatori. L'API Speech-to-Text consente di inviare audio e ricevere una trascrizione del testo dal servizio.

Obiettivi didattici

In questo lab imparerai a:

Creare una chiave API.
Creare una richiesta all'API Speech-to-Text.
Chiamare l'API Speech-to-Text.

Configurazione e requisiti

Prima di fare clic sul pulsante Avvia lab

Leggi le seguenti istruzioni. I lab sono a tempo e non possono essere messi in pausa. Il timer si avvia quando fai clic su Inizia il lab e ti mostra per quanto tempo avrai a disposizione le risorse Google Cloud.

Con questo lab pratico avrai la possibilità di completare le attività in un ambiente cloud reale e non di simulazione o demo. Riceverai delle nuove credenziali temporanee che potrai utilizzare per accedere a Google Cloud per la durata del lab.

Per completare il lab, avrai bisogno di:

Accesso a un browser internet standard (Chrome è il browser consigliato).

Nota: per eseguire questo lab, utilizza una finestra del browser in modalità di navigazione in incognito (consigliata) o privata. Ciò evita conflitti tra il tuo account personale e l'account studente, che potrebbero causare addebiti aggiuntivi sul tuo account personale.

È ora di completare il lab: ricorda che, una volta iniziato, non puoi metterlo in pausa.

Nota: utilizza solo l'account studente per questo lab. Se utilizzi un altro account Google Cloud, potrebbero essere addebitati costi su quell'account.

Come iniziare il lab e accedere alla console Google Cloud

Fai clic sul pulsante Inizia il lab. Se devi effettuare il pagamento per il lab, si aprirà una finestra di dialogo per permetterti di selezionare il metodo di pagamento. A destra, trovi il riquadro Configurazione e accesso al lab con le seguenti informazioni:
- Il pulsante Apri console Google Cloud
- Le credenziali temporanee (nome utente e password) da utilizzare per il lab
- Altre informazioni per seguire questo lab, se necessario
Tieni presente che il timer del lab si trova nella parte superiore della pagina e mostra il tempo rimanente.
Fai clic su Apri console Google Cloud (o fai clic con il tasto destro del mouse e seleziona Apri link in finestra Incognito se utilizzi il browser Chrome).

Il lab avvia le risorse e apre un'altra scheda con la pagina di accesso.

Suggerimento: disponi le schede in finestre separate posizionate fianco a fianco.
Nota: se visualizzi la finestra di dialogo Scegli un account, fai clic su Usa un altro account.
Se necessario, copia il Nome utente di seguito e incollalo nella finestra di dialogo Accedi.
{{{user_0.username | "Username"}}}
Puoi trovare il Nome utente anche nel riquadro Configurazione e accesso al lab.
Fai clic su Avanti.
Copia la Password di seguito e incollala nella finestra di dialogo Ti diamo il benvenuto.
{{{user_0.password | "Password"}}}
Puoi trovare la Password anche nel riquadro Configurazione e accesso al lab.
Fai clic su Avanti.
Importante: devi utilizzare le credenziali fornite dal lab. Non utilizzare le credenziali del tuo account Google Cloud. Nota: utilizzare il tuo account Google Cloud per questo lab potrebbe comportare addebiti aggiuntivi.
Fai clic nelle pagine successive:
- Accetta i termini e le condizioni.
- Non inserire opzioni di recupero o l'autenticazione a due fattori, perché si tratta di un account temporaneo.
- Non registrarti per le prove senza costi.

Dopo qualche istante, la console Google Cloud si apre in questa scheda.

Nota: per accedere ai prodotti e ai servizi Google Cloud, fai clic sul menu di navigazione o digita il nome del servizio o del prodotto nel campo Cerca. Icona del menu di navigazione e campo Cerca

Icona del menu di navigazione e campo Cerca

Attiva Cloud Shell

Cloud Shell è una macchina virtuale in cui sono caricati strumenti per sviluppatori. Offre una home directory permanente da 5 GB e viene eseguita su Google Cloud. Cloud Shell fornisce l'accesso da riga di comando alle risorse Google Cloud.

Fai clic su Attiva Cloud Shell nella parte superiore della console Google Cloud.
Fai clic nelle seguenti finestre:
- Continua nella finestra delle informazioni di Cloud Shell.
- Autorizza Cloud Shell a utilizzare le tue credenziali per effettuare chiamate API Google Cloud.

Quando la connessione è attiva, l'autenticazione è già avvenuta e il progetto è impostato sul tuo Project_ID, . L'output contiene una riga che dichiara il Project_ID per questa sessione:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud è lo strumento a riga di comando di Google Cloud. È preinstallato su Cloud Shell e supporta il completamento tramite tasto Tab.

(Facoltativo) Puoi visualizzare il nome dell'account attivo con questo comando:

gcloud auth list

Fai clic su Autorizza.

Output:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

(Facoltativo) Puoi elencare l'ID progetto con questo comando:

gcloud config list project

Output:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}}

Nota: per la documentazione completa di gcloud, in Google Cloud, fai riferimento alla guida Panoramica dell'interfaccia a riga di comando gcloud.

Attività 1: crea una chiave API

Poiché utilizzerai curl per inviare una richiesta all'API Speech-to-Text, devi generare una chiave API che dovrai passare nell'URL della richiesta.

Per creare una chiave API, fai clic su menu di navigazione > API e servizi > Credenziali.
Fai clic su + Crea credenziali.
Seleziona Chiave API dal menu a discesa.
Nel riquadro laterale Crea chiave API, in API accessibili utilizzando questa chiave, fai clic sul menu a discesa (Seleziona limitazioni dell'API).
Per l'API Cloud Speech-to-Text, seleziona la casella e fai clic su Ok.
Fai clic su Crea.
Copia la chiave appena generata e fai clic su Chiudi.
In Cloud Shell, salva la chiave API in una variabile di ambiente inserendo il comando seguente e sostituendo <YOUR_API_KEY> con la chiave che hai appena copiato:

export API_KEY=<YOUR_API_KEY>

Fai clic su Controlla i miei progressi per verificare l'obiettivo.

Crea una chiave API

Attività 2: crea una richiesta all'API Speech-to-Text

Nota: utilizzerai un file pre-registrato disponibile in Cloud Storage: gs://cloud-samples-tests/speech/brooklyn.flac. Ascolta il file audio prima di inviarlo all'API Speech-to-Text.

Crea il file request.json in Cloud Shell. Utilizzerai questo file per creare la tua richiesta all'API Speech-to-Text:

touch request.json

Apri request.json:

nano request.json

Nota: puoi utilizzare il tuo editor della riga di comando preferito (nano, vim, emacs) o gcloud. Le istruzioni in questo lab sono per nano.

Aggiungi quanto segue al file request.json utilizzando il valore dell'uri del file audio RAW di esempio:

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

Premi Ctrl+X, Y, Invio per chiudere il file request.json.

Il corpo della richiesta contiene un oggetto config e un oggetto audio.

In config, indichi all'API Speech-to-Text come elaborare la richiesta. Il parametro encoding indica all'API quale tipo di codifica audio viene utilizzato durante l'invio del file all'API. FLAC è il tipo di codifica per i file .raw. Scopri di più sui tipi di codifica nella Guida a RecognitionConfig.

Esistono altri parametri che puoi aggiungere all'oggetto config, ma encoding è l'unico obbligatorio.

Nell'oggetto audio, passi all'API l'URI del file audio in Cloud Storage.

Ora è tutto pronto per chiamare l'API Speech-to-Text.

Attività 3: chiama l'API Speech-to-Text

Utilizza il seguente comando curl (tutto in un'unica riga di comando) per passare all'API Speech-to-Text il corpo della richiesta insieme alla variabile di ambiente della chiave API:

curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \ "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}"

La risposta dovrebbe avere un aspetto simile al seguente:

{ "results": [ { "alternatives": [ { "transcript": "how old is the Brooklyn Bridge", "confidence": 0.9311077 } ], "resultEndTime": "1.770s", "languageCode": "en-us" } ], "totalBilledTime": "2s", "requestId": "1573191382345569448" }

Il valore transcript restituirà la trascrizione del testo del file audio eseguita dall'API Speech-to-Text e il valore confidence indica in che misura l'API è sicura di aver trascritto l'audio in modo accurato.

Noterai che la richiesta precedente conteneva una chiamata al metodo syncrecognize. L'API Speech-to-Text supporta la trascrizione sincrona e asincrona della conversione della voce in testo. In questo esempio è stato inviato un file audio completo, ma puoi usare anche il metodo syncrecognize per eseguire una conversione della voce in testo in streaming mentre l'utente sta ancora parlando.

Hai creato una richiesta all'API Speech-to-Text API e poi hai chiamato questa API.

Esegui il comando seguente per salvare la risposta in un file result.json:

curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \ "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}" > result.json

Carica il file result.json nel bucket Cloud Storage:

gcloud storage cp result.json gs://{{{project_0.project_id | PROJECT_ID}}}-speech/

Fai clic su Controlla i miei progressi per verificare l'obiettivo.

Chiama l'API Speech-to-Text e salva il risultato

Complimenti!

Hai utilizzato l'API Speech-to-Text per recuperare una trascrizione di un file audio di input.

Prossimi passi/Scopri di più

Questo lab fa anche parte di una serie di lab chiamata Qwik Starts, pensata per offrirti un piccolo assaggio delle diverse funzionalità disponibili in Google Cloud. Cerca "Qwik Starts" nel catalogo dei lab per trovare il prossimo lab da seguire.

Formazione e certificazione Google Cloud

… per utilizzare al meglio le tecnologie Google Cloud. I nostri corsi ti consentono di sviluppare competenze tecniche e best practice per aiutarti a metterti subito al passo e avanzare nel tuo percorso di apprendimento. Offriamo vari livelli di formazione, dal livello base a quello avanzato, con opzioni di corsi on demand, dal vivo e virtuali, in modo da poter scegliere il più adatto in base ai tuoi impegni. Le certificazioni ti permettono di confermare e dimostrare le tue abilità e competenze relative alle tecnologie Google Cloud.

Ultimo aggiornamento del manuale: 1° ottobre 2026

Ultimo test del lab: 1° ottobre 2026

Copyright 2026 Google LLC. Tutti i diritti riservati. Google e il logo Google sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle rispettive società a cui sono associati.