v1

latestOpenAPI 3.1.02026-08-04576672.7 KB

Generate

Synthesize complete text and stream PCM16 audio.

post/v1/tts/generate

Request body

textstring required

Text to synthesize

cfg_scalenumber

Classifier-free guidance scale (clamped to 1.2–2.5)

temperaturenumber

Sampling variance. 0 = most stable, 1 = most variance.

max_new_tokensinteger

Maximum tokens to generate

sample_rateinteger

Output sample rate in Hz

languagestring nullable

Language code (e.g., 'en', 'de')

model_idstring nullable

Model to use

normalizeboolean

Enable text normalization

project_idinteger nullable

Project ID for custom dictionary lookup

dictionary_idsinteger[] nullable

Per-request dictionary selection. Omit for the default behavior (all active dictionaries of the project apply, filtered by language). An empty list disables dictionaries for this request. A list of dictionary IDs applies exactly those dictionaries — including inactive ones — bypassing the language filter.

speednumber

Playback speed multiplier (0.8 = slower, 1.2 = faster)

output_formatstring nullable

Combined codec+rate token (e.g. 'pcm_8000', 'ulaw_8000', 'alaw_8000'). Opt-in; when set it is authoritative and must not contradict 'sample_rate'. Absent ⇒ legacy 'sample_rate' path (linear PCM16).

Response

Successful Response

{"stackTrail":"paths:/v1/tts/generate:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}