geniete-voice 0.1.0

GenieTé Voice Python SDK — text in, speech out for AI agents

geniete-voice

Python SDK for GenieTé Voice — text in, speech out for AI agents. One call turns words into an MP3, a hosted link, or live speech on a page you leave open anywhere.

pip install geniete-voice

from geniete_voice import Speaker

spk = Speaker(api_key="vk_...", speaker_id="spk_...")

spk.say("Deploy finished. All checks green.")     # plays on your listen pages
url = spk.speak_url("Sixty-second summary ...")   # hosted MP3, plays anywhere
mp3 = spk.speak_bytes("Hello out loud.")          # raw MP3 bytes

link = spk.listen_link(ttl_seconds=86_400)        # standing speaker page
print(link["url"])                                # open on any device

Async twin: AsyncSpeaker, same methods awaited.

Create speakers and API keys in the Voice console. Full docs: https://voice.geniete.com/docs/voice/. Errors raise VoiceError with the server's reason (insufficient_credits, free_daily_ceiling, text_too_long, ...).

MIT © Genie, Inc.