Skip to main content
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 muga and faster mulberry.
  • default audio contract: 24 khz mono 16-bit pcm; create returns a ready-to-play wav.

​
requirements

python 3.9 to 3.13. streaming and sessions need the ws extra (pip install "rumik-ai[ws]").

​
next

quickstart

install, authenticate, and synthesize your first clip.

synthesis

batch, streaming, sessions, and async.
the direct api also supports opus, pcm, mulaw, alaw, and mp3. see audio formats for request and response examples.