Regular recognition of audio files from Yandex Object Storage

The SpeechKit asynchronous recognition API is integrated with Yandex Object Storage. This enables you to set up automatic recognition of audio files of supported formats that are regularly uploaded to an Object Storage bucket. A cloud function in Yandex Cloud Functions regularly checks the bucket for audio files and sends them to the SpeechKit API for recognition. The recognition result and status are saved to the same Object Storage bucket.

To set up automatic audio file recognition using SpeechKit:

1. Create a cloud function to read files from your Object Storage bucket, send them to the API, and check the file recognition status.
2. Create a trigger to regularly invoke your cloud function.
3. Test the function.

Getting startedGetting started

1. Create a service account named asr-batch-sa.

2. Assign to the service account the storage.editor, functions.functionInvoker, and ai.speechkit-stt.user roles for the folder in which it was created.

3. Create a static access key for the service account.

4. Create an API key to access the service account.

5. Create an Object Storage bucket named asr-batch-bucket in the service account folder.

6. Open asr-batch-bucket, click Create folder, and set the Folder name field to input.

7. Upload a config.json file with a set recognition language to the bucket's input folder. The file only contains one parameter:

   {
     "lang": "<language_code>"
   }
   

   Note

   If there is no config.json file in the bucket, the recognition language is Russian.

Create a cloud functionCreate a cloud function

1. In the management console, navigate to the folder with the new service account.

2. Select Cloud Functions.

3. Click Create function and specify asr-batch-function as the function name.

4. Click Create.

5. Under Editor, select Python 3.8 as the runtime environment and click Continue.

6. Download a script file from the Yandex Cloud repository.

7. Under Function code, clear the contents of the index.py file and paste the downloaded script.

8. Under Function code, create a file named requirements.txt and add the following code to it:

   boto3
   botocore
   requests
   

9. Specify the function run parameters:

   • Entry point: index.handler
   • Timeout, sec: 60
   • Service account: asr-batch-sa

10. Add environment variables:

    • S3_BUCKET: asr-batch-bucket
    • S3_PREFIX: input
    • S3_PREFIX_LOG: log
    • S3_PREFIX_OUT: out
    • S3_KEY: ID of the static access key
    • S3_SECRET: Secret of the static access key
    • API_KEY: ID of the API key
    • API_SECRET: Secret of the API key

11. Click Save changes.

Create a triggerCreate a trigger

1. In the management console, select Cloud Functions.
2. Select Triggers.
3. Click Create trigger.
4. Specify the trigger parameters:
   • Name: asr-batch-cron
   • Type: Timer
   • Launched resource: Function
   • Cron expression: Every minute
   • Function: asr-batch-function
   • Function version tag: $latest
   • Service account: asr-batch-sa
5. Click Create trigger.

The trigger you created will fire once a minute and invoke the cloud function.

Test the functionTest the function

1. In the management console, select Object Storage and open asr-batch-bucket.
2. Upload audio files of any supported format to the input folder.
3. Wait a few minutes and make sure the bucket contains the log and out folders.
4. Check the recognition status in the log folder. The status of each audio file sent for recognition is saved to an <audio_file_name>.json auxiliary file (such as audio.mp3.json). If the file contains the "done": "false" parameter, the recognition process is not completed.
5. Check the recognition result in the out folder. The result is saved to an <audio_file_name>.json file (such as audio.mp3.json). For more information about the recognition result format, see Asynchronous recognition API.

See alsoSee also

• Asynchronous recognition API v2
• Asynchronous recognition of LPCM audio files using the API v2
• Asynchronous recognition of OggOpus audio files using the API v2