Tonwerk
caption cefr
English only. Tokenises the caption text, resolves contractions and inflections (about 150 irregular forms plus -s/-es/-ed/-ing/-er/-est/-ly rules) and looks every word up in the CEFR-J Wordlist 1.5 (A1–B2, 7,799 entries, Tono Laboratory TUFS, free for commercial use with citation) and the Octanove Vocabulary Profile C1/C2 1.0 (CC BY-SA 4.0), both from github.com/openlanguageprofiles/olp-en-cefrj at commit d4e45b7. Names (capitalised words that are not in the lists) and numbers are skipped;.
POST https://ton.halowerk.com/v1/caption-cefrInputs
| Field | Type | Required | Description |
|---|---|---|---|
| captions | string | No | Captions or subtitles as SRT or WebVTT text. |
| captions_format | string | No | Format of captions; auto detects WEBVTT headers, otherwise SRT. |
| text | string | No | Alternative to captions: English plain text. |
| coverage_target | number | No | Share of known tokens a learner needs (0.95 after Laufer 1989, 0.98 after Hu & Nation 2000). |
| target_level | string | No | Words above this level are listed as difficult. |
| max_words | integer | No | Maximum number of difficult words and cues listed. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"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."
},
"text": {
"type": "string",
"minLength": 10,
"maxLength": 200000,
"description": "Alternative to captions: English plain text."
},
"coverage_target": {
"type": "number",
"enum": [
0.9,
0.95,
0.98
],
"default": 0.95,
"description": "Share of known tokens a learner needs (0.95 after Laufer 1989, 0.98 after Hu & Nation 2000)."
},
"target_level": {
"type": "string",
"enum": [
"A1",
"A2",
"B1",
"B2",
"C1",
"C2"
],
"default": "B1",
"description": "Words above this level are listed as difficult."
},
"max_words": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 30,
"description": "Maximum number of difficult words and cues listed."
}
}
}Published input example
{
"text": "I have a dog. It is big and black. My mother likes the dog. We go to the park every day. The dog runs and plays with a ball. I am happy.",
"target_level": "A2"
}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
- Tonwerk0.01 USDC
accessible transcript html
POSThttps://ton.halowerk.com/v1/accessible-transcript-htmlParses SRT or WebVTT (voice tags <v Name>, "NAME:" prefixes and ">>" speaker changes) or a segments array, merges consecutive cues of the same speaker into turns (a new paragraph after a pause longer than paragraph_gap_s), and writes semant
- Tonwerk0.01 USDC
ad disclosure audio
POSThttps://ton.halowerk.com/v1/ad-disclosure-audioDecodes the complete supplied clip to mono 16 kHz using resource-limited ffmpeg, checks for speech with Silero VAD v6.2 (MIT), and transcribes locally with the pinned Whisper base ONNX model (MIT / Apache-2.0). Conservative English phrase r
- Tonwerk0.005 USDC
ad insertion markers
POSThttps://ton.halowerk.com/v1/ad-insertion-markersRuns ffmpeg 6.1 silencedetect on the episode audio (base64 or URL, at most 10 MiB) and builds mid-roll candidates from internal silences and from Podcasting 2.0 chapter boundaries (a boundary inside a silence or snapped to the nearest silen