Text Normalization - KugelAudio

Text normalization converts numbers, dates, times, and other non-verbal text into spoken words (for example “3 apples” becomes “three apples”). How it works, the supported languages and their codes are documented in Text processing. The Python SDK controls it with the normalize and language arguments:

# With explicit language (recommended)
audio = client.tts.generate(
    text="I bought 3 items for €50.99 on 01/15/2024.",
    voice_id=1071,
    normalize=True,
    language="en",
)

# Without language: normalized in the voice's primary language (English if none)
audio = client.tts.generate(
    text="Ich habe 3 Artikel für 50,99€ gekauft.",
    voice_id=1071,
    normalize=True,
    # language not specified: the voice's primary language is used
)

Using normalize=True without specifying language may cause incorrect normalizations, especially for short texts or languages that share similar vocabulary. Always specify language when you know it.

Spell Tags

Wrap text in <spell> tags to have it read character by character (emails, codes, acronyms). Tag semantics and per-language character names are in Spell tags. In a streaming session, a tag split across tokens is handled for you:

async with client.tts.streaming_session(
    voice_id=1071,
    normalize=True,
    language="en",
) as session:
    async for chunk in session.send("My code is <spell>"):
        play_audio(chunk.audio)
    async for chunk in session.send("ABC123</spell>"):
        play_audio(chunk.audio)
    async for chunk in session.flush():
        play_audio(chunk.audio)

play_audio stands for your own playback function.

Next steps

Dictionaries: per-project pronunciation and replacement lists
Generate Speech: generation parameters including normalize and language

Last modified on September 22, 2026