Synthesize or non-streaming (Gen2)

Synthesize (Gen 2) sends the full text in one request and returns a file URL when generation finishes. Use it for studio voiceover: ads, narration, e-learning, and other offline playback where you need styles, pause tags, audio duration, or variations.

Use HTTP streaming when you need audio chunks in real time, or WebSocket when text arrives in pieces.

Quickstart

Generate an audio file from text with POST /v1/speech/generate. The response includes a link to the file. The file remains available for 72 hours.

# Export an environment variable on macOS or Linux systems
export MURF_API_KEY="your_api_key_here"

pip install murf

from murf import Murf
client = Murf()
res = client.text_to_speech.generate(
    text="There is much to be said",
    voice_id="Terrell",
    locale="en-US",
    model_version="GEN2",
)
print(res.audio_file)

Voices

Pick a voice from the Gen 2 list in the Voice Library. Gen 2 has 150+ voices and 20+ speaking styles. Gen 2 voices are for studio voiceover.

Endpoint

https://api.murf.ai/v1/speech/generate

Each in-flight generate request counts toward Synthesize (Gen 2) concurrency. A request can include up to 3,000 characters. Split longer scripts across multiple calls.

The machine-readable request and response are in the Synthesize Speech API reference.

Speech customization

Voice, locale, speed, and pitch are available. Style control, custom pause tags, audio duration, and variations are Synthesize (Gen 2) only. Set pronunciations with pronunciationDictionary.

See Speech Customization for ranges and samples.

Supported output formats

The default output format is WAV. Set format, channelType, and sampleRate in the request. The API supports stereo and mono, and sample rates of 8000, 24000, 44100, and 48000 Hz.

from murf import Murf
client = Murf()
res = client.text_to_speech.generate(
    text="Hi, How are you doing today?",
    voice_id="Julia",
    locale="en-US",
    model_version="GEN2",
    format="MP3",
    channel_type="STEREO",
    sample_rate=44100,
)
print(res.audio_file)

Base64 encoding

Base64 encoding is Synthesize (Gen 2) only. Set encodeAsBase64 to true to receive the audio inline instead of a file URL. That also enables zero retention of audio data on Murf’s servers.

from murf import Murf
client = Murf()
res = client.text_to_speech.generate(
    text="Hi, How are you doing today?",
    voice_id="Julia",
    model_version="GEN2",
    encode_as_base_64=True,
)
print(res.encoded_audio)

The response includes the audio encoded in Base64:

{
  ...,
  "encodedAudio": "U29tZSB0ZXh0IHNob3cgd2l0aCB0aGF0Lg==...",
  ...
}

gzip

gzip is Synthesize (Gen 2) only. Include gzip in the accept-encoding header. This is especially useful with Base64 audio.

from murf import Murf
client = Murf()
client.text_to_speech.generate(
    text="Hi, How are you doing today?",
    voice_id="Natalie",
    model_version="GEN2",
    encode_as_base_64=True,
    request_options={
        "additional_headers": {
            "accept-encoding": "gzip"
        }
    },
)

Next Steps

FAQs