synthesize speech as json
synthesize an utterance and return a json object whose audio_base64 field contains the requested audio bytes as base64. omit audio_format for wav, or request opus, pcm, mulaw, alaw, or mp3. the remaining response fields keep their existing behavior.
Authorizations
your rumik api key, e.g. rk_live_.... create one in the rumik dashboard.
Body
text to synthesize. up to 2000 characters. for muga, prefix with a tone tag, e.g. [happy].
2000"[happy] namaste! kaise hain aap?"
which model to use. muga is steered by a tone tag in the text; mulberry is steered by a natural-language description.
muga, mulberry optional output format. omit the field for the original wav response. explicit null, wav, ogg, and unsupported values return 400 UNSUPPORTED_AUDIO_FORMAT.
opus, pcm, mulaw, alaw, mp3 set false to send text to the model exactly as written. see normalization.
always send it for mulberry. natural-language voice/style description. the voice is built from this. send it on every mulberry request, including when speaker is set. if it is missing or empty the api does not reject the request, it falls back to a generic neutral voice. not used by muga. billed with the text: when sent, its characters count at the same per-character rate.
"a female 30s hindi voice, smooth timbre, conversational pacing, like a podcast host"
mulberry only. optional named voice, case-insensitive. emma, mia, sophia, ava, ira, siya, aisha and zoya are female; lucas, noah, theo and adam are male. omit and a voice is generated from description. description is required either way.
emma, mia, sophia, ava, ira, siya, aisha, zoya, lucas, noah, theo, adam "siya"
sampling temperature.
nucleus sampling.
top-k sampling.
penalize repeated tokens.
output length cap. for mulberry, if long text comes back truncated, raise this above the default 2048 (up to 8000; the engine clamps higher values, it does not reject them).
x <= 8192Response
json response containing base64-encoded audio in the requested format.
base64-encoded audio bytes in the requested format; wav when audio_format was omitted.
server-derived source audio duration in integer milliseconds.
x >= 0identifier for this synthesis request.
legacy credit usage. payg and unlimited requests return zero.
x >= 0payg charge in integer nanounits of the account's billing currency. unlimited and legacy-credit requests return zero.
x >= 0the named voice, present when the request set speaker on mulberry, as sent.
"siya"