Skip to content
HALOWERK

Tonwerk

easy language transcript

German only, no language model. Joins caption cues and hyphenated line breaks, then applies deterministic rewrites: about 35 common abbreviations expanded (z. B. -> zum Beispiel, ca. -> ungefähr), cardinal number words to digits (drei -> 3, dreiundzwanzig -> 23), dates 13.11.2026 -> 13. November 2026, %, € and & spelled out, and main clauses joined by ", und/aber/oder/denn/doch" or ";" split into separate sentences when both parts have at least three words. Each resulting sentence is checked.

POST https://ton.halowerk.com/v1/easy-language-transcript

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringNoGerman transcript as plain text.
captionsstringNoCaptions or subtitles as SRT or WebVTT text.
captions_formatstringNoFormat of captions; auto detects WEBVTT headers, otherwise SRT.
max_sentence_wordsintegerNoSentences with more words are flagged (BITV No. 5 asks for short sentences without a number; 12 is a configurable working limit).
long_word_lettersintegerNoWords with at least this many letters and no hyphen are flagged as long words.
split_clausesbooleanNoSplit main clauses joined by comma + und/aber/oder/denn/doch or by semicolons into separate sentences.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "text": {
      "type": "string",
      "minLength": 10,
      "maxLength": 60000,
      "description": "German transcript as plain text."
    },
    "captions": {
      "type": "string",
      "minLength": 10,
      "maxLength": 400000,
      "description": "Captions or subtitles as SRT or WebVTT text."
    },
    "captions_format": {
      "type": "string",
      "enum": [
        "auto",
        "srt",
        "vtt"
      ],
      "default": "auto",
      "description": "Format of captions; auto detects WEBVTT headers, otherwise SRT."
    },
    "max_sentence_words": {
      "type": "integer",
      "minimum": 5,
      "maximum": 30,
      "default": 12,
      "description": "Sentences with more words are flagged (BITV No. 5 asks for short sentences without a number; 12 is a configurable working limit)."
    },
    "long_word_letters": {
      "type": "integer",
      "minimum": 8,
      "maximum": 30,
      "default": 13,
      "description": "Words with at least this many letters and no hyphen are flagged as long words."
    },
    "split_clauses": {
      "type": "boolean",
      "default": true,
      "description": "Split main clauses joined by comma + und/aber/oder/denn/doch or by semicolons into separate sentences."
    }
  }
}

Open original schema

Published input example

{
  "text": "Die Sitzung beginnt z. B. um 10 Uhr, und sie dauert drei Stunden. Der Antrag wird vom Amt geprüft."
}

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 →