Console
    Contact Us Start free

    Transcribe speech to text by using the command line

    This page shows you how to send a speech recognition request to Speech-to-Text using the REST interface and the curl command.

    Speech-to-Text enables easy integration of Google speech recognition technologies into developer applications. You can send audio data to the Speech-to-Text API, which then returns a text transcription of that audio file. For more information about the service, see Speech-to-Text basics .

    Before you begin

    1. 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.

    2. 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 ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission. Learn how to grant roles .

      Go to project selector

    3. Verify that billing is enabled for your Google Cloud project .

    4. Enable the Speech-to-Text APIs.

      Roles required to enable APIs

      To enable APIs, you need the Service Usage Admin IAM role ( roles/serviceusage.serviceUsageAdmin ), which contains the serviceusage.services.enable permission. Learn how to grant roles .

      Enable the APIs

    5. Make sure that you have the following role or roles on the project: Cloud Speech Administrator

      Check for the roles

      1. In the Google Cloud console, go to the IAM page.

        Go to IAM
      2. Select the project.

      3. 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.

      4. 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

      1. In the Google Cloud console, go to the IAM page.

        Go to IAM
      2. Select the project.
      3. Click Grant access .

      4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

      5. In the Select a role list, select a role.
      6. To grant additional roles, click Add another role and add each additional role.
      7. Click Save .

    6. Install the Google Cloud CLI.

    7. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity .

    8. To initialize the gcloud CLI, run the following command:

      gcloud  
init

    9. 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 ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission. Learn how to grant roles .

      Go to project selector

    10. Verify that billing is enabled for your Google Cloud project .

    11. Enable the Speech-to-Text APIs.

      Roles required to enable APIs

      To enable APIs, you need the Service Usage Admin IAM role ( roles/serviceusage.serviceUsageAdmin ), which contains the serviceusage.services.enable permission. Learn how to grant roles .

      Enable the APIs

    12. Make sure that you have the following role or roles on the project: Cloud Speech Administrator

      Check for the roles

      1. In the Google Cloud console, go to the IAM page.

        Go to IAM
      2. Select the project.

      3. 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.

      4. 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

      1. In the Google Cloud console, go to the IAM page.

        Go to IAM
      2. Select the project.
      3. Click Grant access .

      4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

      5. In the Select a role list, select a role.
      6. To grant additional roles, click Add another role and add each additional role.
      7. Click Save .

    13. Install the Google Cloud CLI.

    14. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity .

    15. To initialize the gcloud CLI, run the following command:

      gcloud  
init

    Make an audio transcription request

    Use the following code sample to send a recognize REST request to the Speech-to-Text API.

    1. Run this command to create a JSON file as input for the request. Replace /full/path/to/audio/file.wav with the path to the audio file you want to transcribe:

        echo 
  
 "{ 
 \"config\": { 
 \"auto_decoding_config\": {}, 
 \"language_codes\": [\"en-US\"], 
 \"model\": \"long\" 
 }, 
 \"content\": \" 
 $( 
base64  
-w  
 0 
  
 /full/path/to/audio/file.wav 
  
 | 
  
sed  
 's/+/-/g; s/\//_/g' 
 ) 
 \" 
 }" 
 > 
/tmp/data.txt

    2. Use curl to make a recognize request:

       curl  
-X  
POST  
-H  
 "Content-Type: application/json; charset=utf-8" 
  
 \ 
  
-H  
 "Authorization: Bearer 
 $( 
gcloud  
auth  
print-access-token ) 
 " 
  
 \ 
  
-d  
@/tmp/data.txt  
 \ 
  
https://speech.googleapis.com/v2/projects/ PROJECT_ID 
/locations/global/recognizers/_:recognize

      You should see a response similar to the following:

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

    You sent your first request to Speech-to-Text.

    Clean up

    To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.

    1. Optional: Revoke the authentication credentials that you created, and delete the local credential file.

      gcloud  
auth  
application-default  
revoke

    2. Optional: Revoke credentials from the gcloud CLI.

      gcloud  
auth  
revoke

    Console

    • Everything in the project is deleted.If you used an existing project for the tasks in this document, when you delete it, you also delete any other work you've done in the project.
    • Custom project IDs are lost.When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as an appspot.com URL, delete selected resources inside the project instead of deleting the whole project.

    If you plan to explore multiple architectures, tutorials, or quickstarts, reusing projects can help you avoid exceeding project quota limits.

  • In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  • In the project list, select the project that you want to delete, and then click Delete .
  • In the dialog, type the project ID, and then click Shut down to delete the project.

    • gcloud

    • Everything in the project is deleted.If you used an existing project for the tasks in this document, when you delete it, you also delete any other work you've done in the project.
    • Custom project IDs are lost.When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as an appspot.com URL, delete selected resources inside the project instead of deleting the whole project.

    If you plan to explore multiple architectures, tutorials, or quickstarts, reusing projects can help you avoid exceeding project quota limits.

  • In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  • In the project list, select the project that you want to delete, and then click Delete .
  • In the dialog, type the project ID, and then click Shut down to delete the project.

    • What's next
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: