Skip to content
HALOWERK

Tonwerk

tts text normalize de

Rule-based German text normalisation for TTS front ends. Detects ISO and German numeric dates (12.11.2026, 3. Oktober), times (14:30 Uhr), amounts in EUR/USD/CHF/GBP (12,50 €), numbers with units (km/h, kWh, °C, %, Mio.), paragraphs (§ 5a), en-dash ranges, decimals, thousands separators, numbers with leading zeros (read digit by digit) and about 45 unambiguous abbreviations from the Duden list, plus your own abbreviations. Number words follow the official German spelling rules (written.

POST https://ton.halowerk.com/v1/tts-text-normalize-de

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman text.
abbreviationsobjectNoOwn abbreviations, e.g. {"GmbH": "Gesellschaft mit beschränkter Haftung"}; they take precedence.
wrap_speakbooleanNoWrap the SSML in <speak version="1.1" xml:lang="de-DE">.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000,
      "description": "German text."
    },
    "abbreviations": {
      "type": "object",
      "maxProperties": 200,
      "additionalProperties": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "description": "Own abbreviations, e.g. {\"GmbH\": \"Gesellschaft mit beschränkter Haftung\"}; they take precedence."
    },
    "wrap_speak": {
      "type": "boolean",
      "default": false,
      "description": "Wrap the SSML in <speak version=\"1.1\" xml:lang=\"de-DE\">."
    }
  }
}

Open original schema

Published input example

{
  "text": "Am 12.11.2026 um 14:30 Uhr kostet das Ticket 12,50 €, z. B. für 3,5 km."
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →