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>"
}

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].

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.

Available options:

muga,

mulberry

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. not used by muga.

Example:

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

speaker

enum<string>

mulberry only. optional named voice. emma, mia, sophia, ava, ira, siya, aisha and zoya are female; lucas, noah, theo and adam are male. case-insensitive. omit and a voice is generated from description. description is required either way.

Available options:

emma,

mia,

sophia,

ava,

ira,

siya,

aisha,

zoya,

lucas,

noah,

theo,

adam

Example:

"siya"

temperature

number

default:0.6

sampling temperature.

top_p

number

default:0.95

nucleus sampling.

top_k

integer

default:50

top-k sampling.

repetition_penalty

number

default:1.2

penalize repeated tokens.

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).

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>"
}

documentation

sdk

integrations

cookbook

api reference

synthesize speech

Authorizations

Body

Response