synthesize speech
synthesize an utterance and return binary audio. omit audio_format for the original 24 khz mono wav response, or request opus, pcm, mulaw, alaw, or mp3. pass your api key as a bearer token. payg tts is prorated from the exact submitted text character count, including whitespace, punctuation, newlines, and inline tags. the output format and generated audio duration do not change the charge. unlimited usage records both character count and audio milliseconds with zero usage charge.
Authorizations
Body
text to synthesize. up to 2000 characters. for muga, prefix with a tone tag, e.g. [happy].
2000"[happy] namaste! kaise hain aap?"
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"
Response
binary audio in the requested format. when audio_format is omitted, this is a 24 khz mono wav.
The response is of type file.