Tonwerk
transcript pages
Takes episodes inline or from an RSS feed whose items link transcripts via podcast:transcript (up to four transcripts are fetched, preferring VTT, JSON, SRT, HTML). Parses WebVTT voice spans, SRT cards with "Name:" speaker prefixes, word-level Podcast Namespace JSON segments (merged into sentences) and the cite/time/p HTML format, groups cues into speaker paragraphs (at most 120 words, own rule) and renders one page per episode: lang attribute, skip link, landmarks, one h1, cite for.
POST https://ton.halowerk.com/v1/transcript-pagesInputs
| Field | Type | Required | Description |
|---|---|---|---|
| feed_xml | string | No | RSS 2.0 feed as XML text (alternative to feed_url). |
| feed_url | string | No | Public http(s) URL of the RSS feed; fetched when feed_xml is absent (at most 8 MB). |
| site | object | Yes | |
| episodes | array | No | Inline episodes; with a feed, an entry with guid takes its metadata from the matching feed item. |
| max_fetch | integer | No | Feed mode: number of linked transcripts to fetch. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"site"
],
"properties": {
"feed_xml": {
"type": "string",
"minLength": 20,
"maxLength": 8000000,
"description": "RSS 2.0 feed as XML text (alternative to feed_url)."
},
"feed_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public http(s) URL of the RSS feed; fetched when feed_xml is absent (at most 8 MB)."
},
"site": {
"type": "object",
"additionalProperties": false,
"required": [
"base_url"
],
"properties": {
"base_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"description": "Public base URL under which the pages will be published."
},
"podcast_title": {
"type": "string",
"maxLength": 200
},
"language": {
"type": "string",
"maxLength": 35,
"description": "BCP 47 language of the pages (default: feed language or en)."
}
}
},
"episodes": {
"type": "array",
"maxItems": 50,
"description": "Inline episodes; with a feed, an entry with guid takes its metadata from the matching feed item.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"transcript"
],
"properties": {
"title": {
"type": "string",
"maxLength": 300
},
"guid": {
"type": "string",
"maxLength": 500
},
"pub_date": {
"type": "string",
"maxLength": 60
},
"audio_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"transcript": {
"type": "string",
"minLength": 1,
"maxLength": 2000000
},
"format": {
"type": "string",
"enum": [
"auto",
"vtt",
"srt",
"json",
"html",
"text"
],
"default": "auto"
}
}
}
},
"max_fetch": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"default": 4,
"description": "Feed mode: number of linked transcripts to fetch."
}
}
}Published input example
{
"site": {
"base_url": "https://example.com/transcripts/",
"podcast_title": "Example Podcast",
"language": "en"
},
"episodes": [
{
"title": "Episode 1: Hello",
"transcript": "1\n00:00:00,000 --> 00:00:02,500\nWelcome to the show.\n\n2\n00:00:02,500 --> 00:00:05,000\nToday we talk about podcast transcripts.\n",
"format": "srt"
}
]
}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