Text of docs.cloud.google.com › speech-to-text › docs › batch-recognize as Styx crawled it on Nov 20, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Transcribe long audio files into text | Cloud Speech-to-Text | Google Cloud Documentation

Skip to main content Console Sign in Cloud Speech-to-Text Start free Transcribe long audio files into text Stay organized with collections Save and categorize content based on your preferences. This page demonstrates how to transcribe long audio files (longer than one minute) to text using the Speech-to-Text API and asynchronous speech recognition. About asynchronous speech recognition Batch speech recognition starts a long-running audio processing operation.

Use asynchronous speech recognition to transcribe audio that is longer than 60 seconds. For shorter audio, synchronous speech recognition is faster and simpler. The upper limit for asynchronous speech recognition is 480 minutes (8 hours). Batch speech recognition is only able to transcribe audio stored in Cloud Storage. The transcription output can be either provided inline in the response (for single-file batch recognition requests) or written to Cloud Storage.

The batch recognition request returns an Operation that contains information about the ongoing recognition processing of your request. You can poll the operation to know when the operation is complete and transcripts are available. 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. Roles required to select or create a project Select a project : Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on. Create a project : To create a project, you need the Project Creator role ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission.

Learn how to grant roles . Go to project selector Verify that billing is enabled for your Google Cloud project . Enable the Speech-to-Text APIs, if any are not already enabled. Roles required to enable APIs To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role ( roles/owner ). Otherwise, you can get this permission through the Service Usage Admin role ( roles/serviceusage.serviceUsageAdmin ).

Learn how to grant roles . Enable the 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 all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator. For all rows that specify or include you, check the Role column to see 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 person_add Grant access . In the New principals field, enter your user identifier. This is typically the email address for a Google Account. Click Select a role , then search for the role. To grant additional roles, click add Add another role and add each additional role. Click Save . Install the Google Cloud CLI. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity .

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. Roles required to select or create a project Select a project : Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on. Create a project : To create a project, you need the Project Creator role ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission.

Learn how to grant roles . Go to project selector Verify that billing is enabled for your Google Cloud project . Enable the Speech-to-Text APIs, if any are not already enabled. Roles required to enable APIs To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role ( roles/owner ). Otherwise, you can get this permission through the Service Usage Admin role ( roles/serviceusage.serviceUsageAdmin ).

Learn how to grant roles . Enable the 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 all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator. For all rows that specify or include you, check the Role column to see 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 person_add Grant access . In the New principals field, enter your user identifier. This is typically the email address for a Google Account. Click Select a role , then search for the role. To grant additional roles, click add Add another role and add each additional role. Click Save . Install the Google Cloud CLI. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity .

To initialize the gcloud CLI, run the following command: gcloud init 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 . If you're using a local shell, then create local authentication credentials for your user account: gcloud auth application-default login You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity . Also ensure you have installed the client library . Enable access to Cloud Storage 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][speech-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][manage-access].

You can also give the service account more granular access by giving it permission to a specific Cloud Storage bucket: gcloud storage buckets add-iam-policy-binding gs:// BUCKET_NAME \ --member = serviceAccount:service- PROJECT_NUMBER @gcp-sa-speech.iam.gserviceaccount.com \ --role = roles/storage.admin More information about managing access to Cloud Storage is available at [Create and Manage access control lists][buckets-manage-acl] in the Cloud Storage documentation.

Perform batch recognition with inline results Here is an example of performing batch speech recognition on an audio file in Cloud Storage and reading the transcription results inline from the response: Python import os from google.cloud.speech_v2 import SpeechClient from google.cloud.speech_v2.types import cloud_speech PROJECT_ID = os . getenv ( "GOOGL

The rest of this page is on the live site.