This page demonstrates how to transcribe a short audio file to text using synchronous speech recognition.
Synchronous speech recognition returns the recognized text for short audio (less than 60 seconds).
Audio content can be sent directly to Speech-to-Text from a local file, or Speech-to-Text can process audio content stored in a Cloud Storage bucket. See the quotas and limits page for limits on synchronous speech recognition requests.
Before you begin
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Speech-to-Text APIs.
-
Make sure that you have the following role or roles on the project: Cloud Speech Administrator
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find the row that has your email address.
If your email address isn't in that column, then you do not have any roles.
- In the Role column for the row with your email address, check whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
- In the New principals field, enter your email address.
- In the Select a role list, select a role.
- To grant additional roles, click Add another role and add each additional role.
- Click Save.
-
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Speech-to-Text APIs.
-
Make sure that you have the following role or roles on the project: Cloud Speech Administrator
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find the row that has your email address.
If your email address isn't in that column, then you do not have any roles.
- In the Role column for the row with your email address, check whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
- In the New principals field, enter your email address.
- In the Select a role list, select a role.
- To grant additional roles, click Add another role and add each additional role.
- Click Save.
-
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your Google Account:
gcloud auth application-default login
Client libraries can use Application Default Credentials to easily authenticate with Google APIs and send requests to those APIs. With Application Default Credentials, you can test your application locally and deploy it without changing the underlying code. For more information, see Authenticate for using client libraries.
Also ensure you have installed the client library
Perform synchronous speech recognition on a local file
Here is an example of performing synchronous speech recognition on a local audio file:
Python
Perform synchronous speech recognition on a remote file
For your convenience, Speech-to-Text API can perform synchronous speech recognition directly on an audio file located in Cloud Storage, without the need to send the contents of the audio file in the body of your request.
Speech-to-Text uses a service account to access your files in Cloud Storage. By default, the service account has access to Cloud Storage files in the same project.
The service account email address is the following:
service-PROJECT_NUMBER@gcp-sa-speech.iam.gserviceaccount.com
In order to transcribe Cloud Storage files in another project, you can give this service account the Speech-to-Text Service Agent role in the other project:
gcloud projects add-iam-policy-binding PROJECT_ID \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-speech.iam.gserviceaccount.com \
--role=roles/speech.serviceAgent
More information about project IAM policy is available at Manage access to projects, folders, and organizations.
You can also give the service account more granular access by giving it permission to a specific Cloud Storage bucket:
gsutil iam ch serviceAccount:service-PROJECT_NUMBER@gcp-sa-speech.iam.gserviceaccount.com:admin \
gs://BUCKET_NAME
More information about managing access to Cloud Storage is available at Create and Manage access control lists in the Cloud Storage documentation.
Here is an example of performing synchronous speech recognition on a file located in Cloud Storage:
Python
Clean up
To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.
-
Optional: Revoke the authentication credentials that you created, and delete the local credential file.
gcloud auth application-default revoke
-
Optional: Revoke credentials from the gcloud CLI.
gcloud auth revoke
Console
gcloud
Delete a Google Cloud project:
gcloud projects delete PROJECT_ID
What's next
- See the reference documentation for synchronous recognition.
- Learn how to transcribe streaming audio.
- Learn how to transcribe long audio files.
- Transcribe audio files using Chirp.
- For best performance, accuracy, and other tips, see the best practices documentation.