AWS Transcribe Programmatically using C# - Windows Console Application 18 minutes

Screenshot from the tutorial

AWS Transcribe Programmatically using C# - A Comprehensive Guide

In this blog post, we will explore how to use Amazon Web Services (AWS) Transcribe programmatically with C#. By the end of this tutorial, you will have a solid understanding of how to set up a Windows Console Application that can transcribe audio files into text.

What is AWS Transcribe?

AWS Transcribe is a service that automatically converts speech into text. It uses advanced machine learning technologies to deliver high-quality transcriptions, making it an invaluable tool for businesses and developers who need to process audio content.

Prerequisites

Before you start, make sure you have the following:

• An AWS account: If you don't have one, sign up at AWS Free Tier.
• Visual Studio installed on your machine.
• Basic understanding of C# and .NET.

Setting Up Your Environment

Step 1: Create an AWS IAM User

1. Go to the AWS Management Console and navigate to IAM (Identity and Access Management).
2. Click on Users and then Add user.
3. Provide a user name and select Programmatic access as the access type.
4. Set permissions by attaching existing policies directly, and select the AmazonTranscribeFullAccess policy.
5. Complete the user creation and save the access key and secret key for later use.

Step 2: Install the AWS SDK for .NET

Open your Visual Studio and create a new Console Application project.

1. In the Solution Explorer, right-click on your project and select Manage NuGet Packages.
2. Search for AWSSDK.TranscribeService and install the package.

You can also install it via the Package Manager Console:

Install-Package AWSSDK.TranscribeService

Writing the C# Code

Step 3: Set Up AWS Credentials

First, create a file named appsettings.json in your project directory to store your AWS credentials:

{
    "AWS": {
        "AccessKey": "YOUR_ACCESS_KEY",
        "SecretKey": "YOUR_SECRET_KEY",
        "Region": "us-east-1" // Change this to your preferred region
    }
}

Step 4: Initialize the AWS Transcribe Client

Now, open the Program.cs file and set up the AWS Transcribe client:

using Amazon;
using Amazon.TranscribeService;
using Amazon.TranscribeService.Model;
using Microsoft.Extensions.Configuration;
using System;
using System.IO;
using System.Threading.Tasks;

namespace AwsTranscribeExample
{
    class Program
    {
        private static IConfigurationRoot Configuration;
        
        static async Task Main(string[] args)
        {
            // Load AWS credentials
            var builder = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("appsettings.json");
            Configuration = builder.Build();

            var accessKey = Configuration["AWS:AccessKey"];
            var secretKey = Configuration["AWS:SecretKey"];
            var region = Configuration["AWS:Region"];

            using (var client = new AmazonTranscribeServiceClient(accessKey, secretKey, RegionEndpoint.GetBySystemName(region)))
            {
                // Implementation will go here
            }
        }
    }
}

Step 5: Create a Transcription Job

Add a method to create a transcription job:

private static async Task CreateTranscriptionJob(AmazonTranscribeServiceClient client, string jobName, string mediaUri)
{
    var request = new StartTranscriptionJobRequest
    {
        TranscriptionJobName = jobName,
        LanguageCode = LanguageCode.EnUS,
        Media = new Media
        {
            MediaFileUri = mediaUri
        },
        OutputBucketName = "your-s3-bucket-name" // Make sure to replace with your S3 bucket name
    };

    var response = await client.StartTranscriptionJobAsync(request);
    Console.WriteLine($"Job Name: {response.TranscriptionJob.TranscriptionJobName}");
    Console.WriteLine($"Job Status: {response.TranscriptionJob.TranscriptionJobStatus}");
}

Step 6: Execute the Transcription Job

You can call the CreateTranscriptionJob method in your Main method:

static async Task Main(string[] args)
{
    // ... (previous code)

    string jobName = "SampleTranscriptionJob";
    string mediaUri = "s3://your-s3-bucket-name/your-audio-file.mp3"; // Replace with your audio file URI

    await CreateTranscriptionJob(client, jobName, mediaUri);
}

Finalizing the Code

At this point, your complete Program.cs should look like this:

using Amazon;
using Amazon.TranscribeService;
using Amazon.TranscribeService.Model;
using Microsoft.Extensions.Configuration;
using System;
using System.IO;
using System.Threading.Tasks;

namespace AwsTranscribeExample
{
    class Program
    {
        private static IConfigurationRoot Configuration;

        static async Task Main(string[] args)
        {
            var builder = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("appsettings.json");
            Configuration = builder.Build();

            var accessKey = Configuration["AWS:AccessKey"];
            var secretKey = Configuration["AWS:SecretKey"];
            var region = Configuration["AWS:Region"];

            using (var client = new AmazonTranscribeServiceClient(accessKey, secretKey, RegionEndpoint.GetBySystemName(region)))
            {
                string jobName = "SampleTranscriptionJob";
                string mediaUri = "s3://your-s3-bucket-name/your-audio-file.mp3"; // Replace with your audio file URI

                await CreateTranscriptionJob(client, jobName, mediaUri);
            }
        }

        private static async Task CreateTranscriptionJob(AmazonTranscribeServiceClient client, string jobName, string mediaUri)
        {
            var request = new StartTranscriptionJobRequest
            {
                TranscriptionJobName = jobName,
                LanguageCode = LanguageCode.EnUS,
                Media = new Media
                {
                    MediaFileUri = mediaUri
                },
                OutputBucketName = "your-s3-bucket-name" // Make sure to replace with your S3 bucket name
            };

            var response = await client.StartTranscriptionJobAsync(request);
            Console.WriteLine($"Job Name: {response.TranscriptionJob.TranscriptionJobName}");
            Console.WriteLine($"Job Status: {response.TranscriptionJob.TranscriptionJobStatus}");
        }
    }
}

Running the Application

Make sure to replace placeholders in the code with your actual AWS credentials and S3 bucket name. Once everything is set, run your application. You should see the transcription job's name and status in the console output.

Conclusion

In this tutorial, we covered how to set up a Windows Console Application in C# to use AWS Transcribe programmatically. You learned how to create an AWS IAM user, set up the AWS SDK for .NET, and implement the necessary code to initiate a transcription job.

With this knowledge, you can now integrate AWS Transcribe into your applications, enabling automatic transcriptions of audio files. Happy coding!

Another view from the tutorial

---

Connect with SkillBakery Studios

Explore more tutorials, tools, and resources:

• skillbakery.com
• Facebook
• X (Twitter)
• YouTube Channel

Posted by SkillBakery Studios