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]. for mulberry-1.6, write each language in its own script, with no tags or markers.
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; mulberry-1.6 speaks 22 indian languages and is steered by an optional style, accent, pace description.
muga, mulberry, mulberry-1.6 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 required for mulberry. natural-language voice/style description. the voice is built from this. send it on every mulberry request, including when speaker is set. optional for mulberry-1.6: a style, an accent and a pace, e.g. happy, Tamil accent, steady pace. a part you leave out defaults to professional, the accent of the text's script, and fast pace. not used by muga.
"a female 30s hindi voice, smooth timbre, conversational pacing, like a podcast host"
mulberry and mulberry-1.6 only. optional named voice, case-insensitive. mulberry: 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. mulberry-1.6: ira, aisha, siya or zoya, all female. omit it, or send a name it doesn't know, and you get ira.
emma, mia, sophia, ava, ira, siya, aisha, zoya, lucas, noah, theo, adam "siya"
sampling temperature. mulberry-1.6 defaults to 0.8.
nucleus sampling. mulberry-1.6 defaults to 1.0.
top-k sampling. mulberry-1.6 defaults to 30.
penalize repeated tokens. ignored by mulberry-1.6.
output length cap. for mulberry, if long text comes back truncated, raise this above the default 2048 (up to 8192). for mulberry-1.6, it is sized from the text (at least 2048, up to 8192), and a larger value you send is kept.
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 or mulberry-1.6. mulberry-1.6 returns the voice it resolved to, e.g. Ira.
"Ira"