Text to Speech

Murf provides a powerful Text to Speech API that allows you to generate high-quality, natural-sounding speech from text input. The API supports over 13 languages and 20 speaking styles across 130 voices to suit your application’s needs.

Quickstart

The Synthesize Speech endpoint lets you generate speech from text input. You can either use the REST API directly or use one of our official SDKs to interact with the API.

1
from murf import Murf
2
3
client = Murf(
4
    api_key="YOUR_API_KEY" # Not required if you have set the MURF_API_KEY environment variable
5
)
6
7
res = client.text_to_speech.generate(
8
    text="There is much to be said",
9
    voice_id="en-US-terrell",
10
)
11
12
print(res.audio_file)

A link to the audio file will be returned in the response. You can use this link to download the audio file and use it wherever you need it. The audio file will be available for download for 24 hours after generation.

Supported Output Formats

The API supports multiple output formats for the generated audio - the default output format is wav. You can choose from the following formats:

You can specify the output format using the format parameter in the request payload in the Synthesize Speech endpoint.

Furthermore, you can use the channelType and sampleRate keys to specify the channel type and sample rate for the generated audio. The API supports stereo and mono channels, and sample rates of 8000, 24000, 44100, and 48000 Hz.

1
from murf import Murf
2
client = Murf()
3
res = client.text_to_speech.generate(
4
    text="Hello world!",
5
    voice_id="en-US-julia",
6
    format="MP3",
7
    channel_type="STEREO",
8
    sample_rate=44100
9
)

Base64 Encoding

You can choose to receive the audio file in Base64 encoded format by setting the base64 parameter to true in the request payload. This can be useful when you need to embed the audio file directly into your application or store it in a database.

1
from murf import Murf
2
client = Murf()
3
res = client.text_to_speech.generate(
4
    text="Hello world!",
5
    voice_id="en-US-julia",
6
    encode_as_base_64=True
7
)

The response will include the audio file encoded in Base64 format, which you can decode and use as needed.

1
{
2
  ...,
3
  "encodedAudio": "U29tZSB0ZXh0IHNob3cgd2l0aCB0aGF0Lg==...",
4
  ...
5
}

gzip Support

Responses from Murf API can be gzipped by including “gzip” in the accept-encoding header of your requests. This is especially beneficial if you choose to return the audio response as a Base64 encoded string.

1
from murf import Murf
2
3
client = Murf()
4
5
client.text_to_speech.generate(
6
        text="Hello, World!",
7
        voice_id="en-US-natalie",
8
        encode_as_base_64=True,
9
        request_options={
10
            'additional_headers': {
11
                'accept-encoding': 'gzip'
12
            }
13
        }
14
)

FAQ