How to synthesize speech in the SpeechKit API v3

In this section, you will learn how to synthesize speech from text using the SpeechKit API v3 (gRPC).

You will need the grpcurl utility to use the API.

Getting startedGetting started

1. Install the grpcurl utility.

2. Install the jq utility for piped processing of JSON files.

   sudo apt update && sudo apt install jq
   

Convert text to an audio fileConvert text to an audio file

To synthesize speech from text with TTS markup to a WAV file:

1. Create a file with the body of an API request and text to synthesize to speech:

   tts_req.json

   {
    "text": "I'm Yandex Speech+Kit. I can turn any text into speech. Now y+ou can, too!",
    "outputAudioSpec": {
      "containerAudio": {
        "containerAudioType": "WAV"
      }
    },
    "hints": [
        {
            "voice": "jane"
        },
        {
            "role": "good"
        }
    ],
    "loudnessNormalizationType": "LUFS"
   }
   

2. Run the following commands:

   export FOLDER_ID=<folder_ID>
   export IAM_TOKEN=<IAM_token>
   jq . -c tts_req.json | \
   grpcurl -H "authorization: Bearer ${IAM_TOKEN}" \
           -H "x-folder-id: ${FOLDER_ID}" \
           -d @ tts.api.cloud.yandex.net:443 speechkit.tts.v3.Synthesizer/UtteranceSynthesis | \
   jq -r '.audioChunk.data' | base64 -d > speech.wav
   

   Where:

   • FOLDER_ID: Folder ID received before starting. If you are using the service account's IAM token, do not specify the folder ID in your request: the service uses the folder where the service account was created.
   • IAM_TOKEN: IAM token received before starting.
   • speech.wav: File where the response will be written.

As a result, the speech.wav file with synthesized speech will be created in the directory.

See alsoSee also

• Learn more about the API v3
• Authentication with the API
• Speech synthesis in the API v3