rumik-ai is the official python client for the silk TTS API. it gives you three ways
to turn text into speech, a single batch call, a real-time stream, or a long-lived
voice-agent session, all behind one small, fully typed client. you write a few lines
of python instead of managing HTTP requests and websocket frames yourself.
the package installs as
rumik-ai but you import rumikai. the API key env var
is RUMIK_API_KEY.three ways to synthesize
batch
one call in, one WAV out. best for pre-generated audio.
streaming
raw PCM over a websocket as it is generated. lowest time to first audio.
sessions
a persistent connection with barge-in, for real-time voice agents.
highlights
- sync and async clients (
Rumik,AsyncRumik) with the same surface. - fully typed: ships
py.typed, so type checkers see everything. - automatic retries on transient errors with jittered backoff, honoring
Retry-After. - two models: expressive
mugaand fastermulberry. - 24 kHz mono 16-bit PCM everywhere;
createreturns a ready-to-play WAV.
requirements
python 3.9 to 3.13. streaming and sessions need thews extra
(pip install "rumik-ai[ws]").
next
quickstart
install, authenticate, and synthesize your first clip.
synthesis
batch, streaming, sessions, and async.