Transcribe

Introduction

Transcribe is a service provided by Amazon Web Services (AWS) that offers automatic speech recognition (ASR) capabilities. It enables developers to convert spoken language into written text, making it valuable for a wide range of applications, from transcription services to voice analytics.

LocalStack supports Transcribe via the Community offering, allowing you to use the Transcribe APIs for offline speech-to-text jobs in your local environment. The supported APIs are available on our API Coverage Page, which provides information on the extent of Transcribe integration with LocalStack.

Getting Started

This guide is designed for users new to Transcribe and assumes basic knowledge of the AWS CLI and our awslocal wrapper script.

Start your LocalStack container using your preferred method. We will demonstrate how to create a transcription job and view the transcript in an S3 bucket using the AWS CLI.

$ docker pull localstack/localstack:2.0.0 --platform amd64

Create an S3 bucket

You can create an S3 bucket using the mb command. Run the following command to create a bucket named foo to upload a sample audio file named example.wav:

$ awslocal s3 mb s3://foo
$ awslocal s3 cp ~/example.wav s3://foo/example.wav

Create a transcription job

You can create a transcription job using the StartTranscriptionJob API. Run the following command to create a transcription job named example for the audio file example.wav:

$ awslocal transcribe start-transcription-job \
    --transcription-job-name example \
    --media MediaFileUri=s3://foo/example.wav \
    --language-code en-IN

You can list the transcription jobs using the ListTranscriptionJobs API. Run the following command to list the transcription jobs:

$ awslocal transcribe list-transcription-jobs
 
{
    "TranscriptionJobSummaries": [
        {
            "TranscriptionJobName": "example",
            "CreationTime": "2022-08-17T14:04:39.277000+05:30",
            "StartTime": "2022-08-17T14:04:39.308000+05:30",
            "LanguageCode": "en-IN",
            "TranscriptionJobStatus": "IN_PROGRESS"
        }
    ]
}

View the transcript

After the job is complete, the transcript can be retrieved from the S3 bucket using the GetTranscriptionJob API. Run the following command to get the transcript:

$ awslocal transcribe get-transcription-job --transcription-job example
 
{
    "TranscriptionJob": {
        "TranscriptionJobName": "example",
        "TranscriptionJobStatus": "COMPLETED",
        "LanguageCode": "en-IN",
        "MediaFormat": "wav",
        "Media": {
            "MediaFileUri": "s3://foo/example.wav"
        },
        "Transcript": {
            "TranscriptFileUri": "s3://foo/7844aaa5.json"
        },
        "CreationTime": "2022-08-17T14:04:39.277000+05:30",
        "StartTime": "2022-08-17T14:04:39.308000+05:30",
        "CompletionTime": "2022-08-17T14:04:57.400000+05:30",
    }
}

$ awslocal s3 cp s3://foo/7844aaa5.json .
$ jq .results.transcripts[0].transcript 7844aaa5.json

"it is just a question of getting rid of the illusion that we are separate from nature"

Examples

The following code snippets and sample applications provide practical examples of how to use Transcribe in LocalStack for various use cases:

• Serverless Transcription App using Transcribe, S3, Lambda, SQS, SES

Limitations

Currently, our Transcribe emulation offers only supported formats and languages.

Supported Formats

The following input media formats are supported:

• Adaptive Multi-Rate (AMR)
• Free Lossless Audio Codec (FLAC)
• MPEG-1 Audio Layer-3 (MP3)
• MPEG-4 Part 14 (MP4)
• OGG
• Matroska Video files (MKV)
• Waveform Audio File Format (WAV)

Supported Languages

The following langauges and dialects are supported: