Quickstart

1
import pyaudio
2
from murf import Murf, MurfRegion
3
4
client = Murf(
5
    api_key="YOUR_API_KEY", # Not required if you have set the MURF_API_KEY environment variable
6
    region=MurfRegion.GLOBAL
7
)
8
9
# For lower latency, specify a region closer to your users
10
# client = Murf(region=MurfRegion.IN)  # Example: India region
11
12
# Audio format settings (must match your API output)
13
SAMPLE_RATE = 24000  
14
CHANNELS = 1
15
FORMAT = pyaudio.paInt16
16
17
def play_streaming_audio():
18
    # Get the streaming audio generator
19
    audio_stream = client.text_to_speech.stream(
20
        text="Hi, How are you doing today?",
21
        voice_id="Matthew",
22
        model="FALCON",
23
        locale="en-US",
24
        sample_rate=SAMPLE_RATE,
25
        format="PCM"
26
    )
27
28
    # Setup audio stream for playback
29
    pa = pyaudio.PyAudio()
30
    stream = pa.open(format=FORMAT, channels=CHANNELS, rate=SAMPLE_RATE, output=True)
31
32
    try:
33
        print("Starting audio playback...")
34
        for chunk in audio_stream:
35
            if chunk:  # Check if chunk has data
36
                stream.write(chunk)
37
    except Exception as e:
38
        print(f"Error during streaming: {e}")
39
    finally:
40
        stream.stop_stream()
41
        stream.close()
42
        pa.terminate()
43
        print("Audio streaming and playback complete!")
44
45
if __name__ == "__main__":
46
    play_streaming_audio()

1
from murf import Murf
2
3
client = Murf()
4
5
audio_res = client.text_to_speech.generate(
6
    text="Lo and Behold! Speech!",
7
    voice_id="Terrell",
8
    locale="en-US"
9
)
10
11
print(audio_res.audio_file)