KUkugelaudio

Generate

Changed on

Synthesize complete text and stream PCM16 audio.

post/v1/tts/generate

Request

Request body

textstring required

Text to synthesize

cfg_scalenumber

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

temperaturenumber nullable

Sampling variance. 0 = most stable, 1 = most variance. Omit to use the engine default.

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

unknown required

Changes

  • b308d168afe2Revision changes
    • breaking

      the request property's minLength was increased from 1 to 2

    • info

      the request property default value 0.4 was removed

    • info

      request property list-of-types was widened by adding types null to media type application/json

  • 80be973fad7dRevision changes
    • breaking

      the request property's max was decreased to 2048.00