---
title: "synthesize speech"
method: POST
path: "/v1/tts"
tags: ["speech"]
---

# synthesize speech

`POST /v1/tts`

synthesize an utterance and return it as a 24 kHz mono WAV file. pass your API key as a bearer token.

## Request body

- TTSRequest
  - `text` string, required — text to synthesize. up to 2000 characters. for `muga`, prefix with a tone tag, e.g. `[happy]`.
  - `model` 'muga' | 'mulberry' — which model to use. `muga` is steered by a tone tag in the text; `mulberry` is steered by a natural-language description.
  - `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`.
  - `speaker` 'emma' | 'mia' | 'sophia' | 'ava' | 'ira' | 'siya' | 'aisha' | 'zoya' | 'lucas' | 'noah' | 'theo' | 'adam' — `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.
  - `temperature` number — sampling temperature.
  - `top_p` number — nucleus sampling.
  - `top_k` integer — top-k sampling.
  - `repetition_penalty` number — penalize repeated tokens.
  - `max_new_tokens` integer — output length cap. for `mulberry`, if long text comes back truncated, raise this above the default 2048 (up to 8192).

## Response `200`

synthesized audio as a 24 kHz mono WAV.

## Other responses

- `400` — malformed request body or unknown model.
- `401` — bearer token missing, invalid, or expired.
- `403` — key revoked or account disabled.
- `422` — validation failed. check the error field.
- `429` — rate limit hit. see the `Retry-After` header.
- `503` — upstream temporarily unavailable. retry shortly.

---

[API](https://skmtc.dev/rumik/apis/silk-tts-api.md) · [All operations](https://skmtc.dev/rumik/apis/silk-tts-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rumik/silk-tts-api/revisions/4b94f5c97e46/schema)