Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Speech To Text Samples

This repo contains a number of code samples showing how to use the [Azure Speech to Text service](https://azure.microsoft.com/services/cognitive-services/speech-to-text/?WT.mc_id=build2020_ca-github-jabenn) from Python. This service is part of a suite of pre-built AI services you can use to add intelligence to your apps in only a few lines of code. These services are known as [Azure Cognitive Services](https://azure.microsoft.com/services/cognitive-services/?WT.mc_id=build2020_ca-github-jabenn).
This repo contains a number of code samples showing how to use the [Azure Speech to Text service](https://azure.microsoft.com/services/cognitive-services/speech-to-text/?WT.mc_id=academic-0000-jabenn) from Python. This service is part of a suite of pre-built AI services you can use to add intelligence to your apps in only a few lines of code. These services are known as [Azure Cognitive Services](https://azure.microsoft.com/services/cognitive-services/?WT.mc_id=academic-0000-jabenn).

![Cognitive services logo](./images/cognitive-services.png)

Expand All @@ -10,23 +10,23 @@ To use these samples, you will need an Azure subscription, and an Azure Speech t

To use Azure services you will need an Azure subscription. If you don't have a subscription you can sign up for free.

* If you are a student aged 18 and up and have an email address from an academic institution, you can sign up for the free Azure for Students offer at [azure.microsoft.com/free/students](https://azure.microsoft.com/free/students/?WT.mc_id=build2020_ca-github-jabenn) without a credit card. At the time of writing this gives you $100 of credit to use over 12 months, as well as free tiers of a number of services for that 12 months. At the end of the 12 months, if you are still a student you can renew and get another $100 in credit and 12 months of free services.
* If you are a student aged 18 and up and have an email address from an academic institution, you can sign up for the free Azure for Students offer at [azure.microsoft.com/free/students](https://azure.microsoft.com/free/students/?WT.mc_id=academic-0000-jabenn) without a credit card. At the time of writing this gives you $100 of credit to use over 12 months, as well as free tiers of a number of services for that 12 months. At the end of the 12 months, if you are still a student you can renew and get another $100 in credit and 12 months of free services.

* If you are not a student, you can sign up at [azure.microsoft.com/free](https://azure.microsoft.com/free/?WT.mc_id=build2020_ca-github-jabenn). You will need a credit card for verification purposes only, you will not be billed unless you decide to upgrade your account to a paid offering. At the time of writing the free account will give you US$200 of free credit to spend on what you like in the first 30 days, 12 months of free services, plus a load of services that have tiers that are always free.
* If you are not a student, you can sign up at [azure.microsoft.com/free](https://azure.microsoft.com/free/?WT.mc_id=academic-0000-jabenn). You will need a credit card for verification purposes only, you will not be billed unless you decide to upgrade your account to a paid offering. At the time of writing the free account will give you US$200 of free credit to spend on what you like in the first 30 days, 12 months of free services, plus a load of services that have tiers that are always free.

## Create the Speech to Text resource

To use the [Azure Speech to Text service](https://azure.microsoft.com/services/cognitive-services/speech-to-text/?WT.mc_id=build2020_ca-github-jabenn), you will need to create a resource in your Azure subscription.
To use the [Azure Speech to Text service](https://azure.microsoft.com/services/cognitive-services/speech-to-text/?WT.mc_id=academic-0000-jabenn), you will need to create a resource in your Azure subscription.

The speech to text service has a number of tiers, providing different pricing, with a generous free tier. At the time of writing you can get 5 hours of audio converted from speech to text a month for free. You can only create one free tier per service per subscription.

> You can find the latest pricing details on the [Speech to Text pricing page](https://azure.microsoft.com/pricing/details/cognitive-services/speech-services/?WT.mc_id=build2020_ca-github-jabenn).
> You can find the latest pricing details on the [Speech to Text pricing page](https://azure.microsoft.com/pricing/details/cognitive-services/speech-services/?WT.mc_id=academic-0000-jabenn).

You can create this resource from the [Azure Portal](https://portal.azure.com/?WT.mc_id=build2020_ca-github-jabenn) or the [Azure CLI](https://docs.microsoft.com/cli/azure/?WT.mc_id=build2020_ca-github-jabenn).
You can create this resource from the [Azure Portal](https://portal.azure.com/?WT.mc_id=academic-0000-jabenn) or the [Azure CLI](https://docs.microsoft.com/cli/azure/?WT.mc_id=academic-0000-jabenn).

### Create the resource using the Azure Portal

1. Launch the [Azure Portal](https://portal.azure.com?WT.mc_id=build2020_ca-github-jabenn)
1. Launch the [Azure Portal](https://portal.azure.com/?WT.mc_id=academic-0000-jabenn)

1. Log in with the account you used to create your Azure subscription

Expand All @@ -50,7 +50,7 @@ You can create this resource from the [Azure Portal](https://portal.azure.com/?W

* Select the subscription you want to use

* Select the location closest to you. You can see the regions on a map on the [Azure Regions page](https://azure.microsoft.com/global-infrastructure/regions/?WT.mc_id=build2020_ca-github-jabenn).
* Select the location closest to you. You can see the regions on a map on the [Azure Regions page](https://azure.microsoft.com/global-infrastructure/regions/?WT.mc_id=academic-0000-jabenn).

* Select the F0 pricing tier. This is the free tier

Expand All @@ -74,7 +74,7 @@ You can create this resource from the [Azure Portal](https://portal.azure.com/?W

### Create the resource using the Azure CLI

1. If you don't have the Azure CLI installed, install it by following [these instructions on Microsoft Docs](https://docs.microsoft.com/cli/azure/install-azure-cli?WT.mc_id=build2020_ca-github-jabenn)
1. If you don't have the Azure CLI installed, install it by following [these instructions on Microsoft Docs](https://docs.microsoft.com/cli/azure/install-azure-cli?WT.mc_id=academic-0000-jabenn)

1. Sign in to the Azure CLI using the following command:

Expand Down Expand Up @@ -108,7 +108,7 @@ You can create this resource from the [Azure Portal](https://portal.azure.com/?W
az account list-locations --output table
```

Note the value from the `name` column for the location closest to you. You can see the regions on a map on the [Azure Regions page](https://azure.microsoft.com/global-infrastructure/regions/?WT.mc_id=build2020_ca-github-jabenn). Make a note of this location as you will need it to run the samples.
Note the value from the `name` column for the location closest to you. You can see the regions on a map on the [Azure Regions page](https://azure.microsoft.com/global-infrastructure/regions/?WT.mc_id=academic-0000-jabenn). Make a note of this location as you will need it to run the samples.

1. Create a resource group to contain your resource. Resource groups are logical groupings of resources that allow you to manage the resources together, for example deleting a resource group to delete all the resources that it contains. Use the following command to do this:

Expand Down Expand Up @@ -164,5 +164,5 @@ All these samples will need the location/region name and key for your Speech to

![A cartoon character from docs.microsoft.com](./images/docs_character.png)

* Learn more with hands-on, self guided learning using the [Process and translate speech with Azure Cognitive Speech Services](https://docs.microsoft.com/learn/paths/translate-speech-with-speech-services/?WT.mc_id=build2020_ca-github-jabenn) learning path on Microsoft Learn.
* Read more on the Python Speech Service SDK on [Microsoft Speech SDK docs](https://docs.microsoft.com/azure/cognitive-services/speech-service/?WT.mc_id=build2020_ca-github-jabenn).
* Learn more with hands-on, self guided learning using the [Process and translate speech with Azure Cognitive Speech Services](https://docs.microsoft.com/learn/paths/translate-speech-with-speech-services/?WT.mc_id=academic-0000-jabenn) learning path on Microsoft Learn.
* Read more on the Python Speech Service SDK on [Microsoft Speech SDK docs](https://docs.microsoft.com/azure/cognitive-services/speech-service/?WT.mc_id=academic-0000-jabenn).