Tonwerk
feed loudness series
Feed mode: takes the newest 1-4 episodes of an RSS feed and fetches only a byte range of each enclosure (by default from the middle of MP3 files, from the start for other containers; large ID3 tags are skipped), so every value is an honest sample measurement, not the loudness of the whole episode. Clip mode: measures 2-6 supplied audio files completely. Each sample is measured with ffmpeg 6.1 ebur128 (integrated loudness with BS.1770 gating, loudness range, true peak with oversampling,.
POST https://ton.halowerk.com/v1/feed-loudness-seriesInputs
| 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). |
| episodes | integer | No | Number of newest episodes to sample (feed mode). |
| sample_seconds | integer | No | Approximate length of each sample in seconds (feed mode). |
| position | string | No | Where to take the sample from (middle only for MP3). |
| clips | array | No | Alternative to a feed: complete audio clips to compare (together at most 14 MB of base64). |
| target | string | No | auto: -19 LUFS for mono files, -16 LUFS otherwise. |
| tolerance_lu | number | No | Allowed deviation from the target (Apple: ±1 dB). |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"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)."
},
"episodes": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"default": 3,
"description": "Number of newest episodes to sample (feed mode)."
},
"sample_seconds": {
"type": "integer",
"minimum": 20,
"maximum": 120,
"default": 60,
"description": "Approximate length of each sample in seconds (feed mode)."
},
"position": {
"type": "string",
"enum": [
"middle",
"start"
],
"default": "middle",
"description": "Where to take the sample from (middle only for MP3)."
},
"clips": {
"type": "array",
"minItems": 2,
"maxItems": 6,
"description": "Alternative to a feed: complete audio clips to compare (together at most 14 MB of base64).",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"audio_base64"
],
"properties": {
"label": {
"type": "string",
"maxLength": 200
},
"audio_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000
}
}
}
},
"target": {
"type": "string",
"enum": [
"auto",
"stereo",
"mono"
],
"default": "auto",
"description": "auto: -19 LUFS for mono files, -16 LUFS otherwise."
},
"tolerance_lu": {
"type": "number",
"minimum": 0.5,
"maximum": 3,
"default": 1,
"description": "Allowed deviation from the target (Apple: ±1 dB)."
}
}
}Published input example
{
"feed_url": "https://podnews.net/rss",
"episodes": 3,
"sample_seconds": 60
}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