speech

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.

POST

tts

curl --request POST \
  --url https://silk-api.rumik.ai/v1/tts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "muga",
  "text": "[happy] namaste! kaise hain aap?"
}
'

"<string>"

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Authorizations

Authorization

string

header

required

your rumik api key, e.g. rk_live_.... create one in the rumik dashboard.

Body

application/json

text

string

required

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.

Maximum string length: 2000

Example:

"[happy] namaste! kaise hain aap?"

model

enum<string>

default:muga

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.

Available options:

muga,

mulberry,

mulberry-1.6

audio_format

enum<string>

optional output format. omit the field for the original wav response. explicit null, wav, ogg, and unsupported values return 400 unsupported_audio_format.

Available options:

opus,

pcm,

mulaw,

alaw,

mp3

description

string

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.

Example:

"a female 30s hindi voice, smooth timbre, conversational pacing, like a podcast host"

speaker

enum<string>

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.

Available options:

emma,

mia,

sophia,

ava,

ira,

siya,

aisha,

zoya,

lucas,

noah,

theo,

adam

Example:

"siya"

temperature

number

default:0.6

sampling temperature. mulberry-1.6 defaults to 0.8.

top_p

number

default:0.95

nucleus sampling. mulberry-1.6 defaults to 1.0.

top_k

integer

default:50

top-k sampling. mulberry-1.6 defaults to 30.

repetition_penalty

number

default:1.2

penalize repeated tokens. ignored by mulberry-1.6.

max_new_tokens

integer

default:2048

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.

Required range: x <= 8192

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.

curl --request POST \
  --url https://silk-api.rumik.ai/v1/tts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "muga",
  "text": "[happy] namaste! kaise hain aap?"
}
'

"<string>"

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

documentation

sdk

integrations

cookbook

api reference

synthesize speech

Authorizations

Body

Response