Tonwerk
intelligibility score
Intrusive measure: both the degraded audio and the clean reference are decoded (mono, 10 kHz, up to 60 s). The degraded signal is aligned to the reference by cross-correlation (up to ±max_delay_s). STOI follows Taal, Hendriks, Heusdens and Jensen (IEEE TASLP 19(7), 2011) exactly as the reference implementation pystoi 0.4: silent frames (40 dB below the loudest reference frame, 256-point frames) are removed, 15 one-third-octave bands from 150 Hz (512-point FFT), 30-frame segments (384 ms),.
POST https://ton.halowerk.com/v1/intelligibility-scoreInputs
| Field | Type | Required | Description |
|---|---|---|---|
| audio_base64 | string | No | Degraded speech recording (e.g. announcement as heard) as base64 (at most 10 MiB decoded; a data: URL prefix is accepted). Formats: WAV/RF64/W64, AIFF, FLAC, MP3/MP2, AAC (ADTS, M4A/MP4), ALAC, Ogg Vorbis/Opus, WebM/Matroska, CAF, WavPack, APE, TTA, AMR, AU, AC-3/E-AC-3, DTS, WMA (ASF), AVI, MPEG-TS/PS, FLV; for video containers the first audio track is used. |
| audio_url | string | No | Public http(s) URL of the degraded speech recording (e.g. announcement as heard) (at most 10 MiB; private and local addresses are refused). |
| reference_base64 | string | No | Clean reference speech as base64 (at most 10 MiB decoded), same content as the recording. |
| reference_url | string | No | Public http(s) URL of the clean reference speech (at most 10 MiB). |
| align | boolean | No | Align the recording to the reference by cross-correlation before scoring. |
| max_delay_s | number | No | Largest delay searched during alignment, in seconds. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"audio_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000,
"description": "Degraded speech recording (e.g. announcement as heard) as base64 (at most 10 MiB decoded; a data: URL prefix is accepted). Formats: WAV/RF64/W64, AIFF, FLAC, MP3/MP2, AAC (ADTS, M4A/MP4), ALAC, Ogg Vorbis/Opus, WebM/Matroska, CAF, WavPack, APE, TTA, AMR, AU, AC-3/E-AC-3, DTS, WMA (ASF), AVI, MPEG-TS/PS, FLV; for video containers the first audio track is used."
},
"audio_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public http(s) URL of the degraded speech recording (e.g. announcement as heard) (at most 10 MiB; private and local addresses are refused)."
},
"reference_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000,
"description": "Clean reference speech as base64 (at most 10 MiB decoded), same content as the recording."
},
"reference_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public http(s) URL of the clean reference speech (at most 10 MiB)."
},
"align": {
"type": "boolean",
"default": true,
"description": "Align the recording to the reference by cross-correlation before scoring."
},
"max_delay_s": {
"type": "number",
"minimum": 0,
"maximum": 2,
"default": 1,
"description": "Largest delay searched during alignment, in seconds."
}
}
}Published input example
{
"audio_base64": "T2dnUwACAAAAAAAAAAAAAAAAAAAAAGS5xGoBE09wdXNIZWFkAQE4AUAfAAAAAABPZ2dTAAAAAAAAAAAAAAAAAAABAAAASZW+VAEuT3B1c1RhZ3MGAAAAZmZtcGVnAQAAABQAAABlbmNvZGVyPUxhdmMgbGlib3B1c09nZ1MAAEC/AAAAAAAAAAAAAAIAAADhL4GbESoiHzMODg4OLiggNA8ODg4cGOA9fQJEOsAG4ZiC90q6E2WRsGLjIRCuNaf7lAuz0yTahU+lMAqu8OuQGOz2ZDwLNQykEKGwt8OxH+BJXGSvBItBnVF8FF2a92eM4BjtQ9qITXm1AIxQ7DMgrRChajUF27IeK65x1oagcQYYiyXmddxEdhG76Bhy4Kl6mrvBTVKEFp6n05W7muBNfM/lXzKTxFfRFpRwHKPsBS8QktAYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hhinizDjUOfWKLGLEbfzhb9vcjHf11RohdAZ2WWPb1l1aTX+ZId4wK7PA0sD4AY7DmIFL3jXBYqbwW8pIXxZnuU0OIUV34zmDLpZzazOB3mn7eli0iaGO1CN80nI8bGnOUrelalWs41A05rtjI4IyXgly1eMagY7G6Dy8IzQI0S2nLAQ+Ga956516XfC/XlWuOyiKngog9G4bacJpjFTy+5Cgz2R6mvzU6AGAgjgayA8fvyrLVuf7vxGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGCKeLMOM2AvXBpA703PGDUD8rrPtALNR8wXxeE9nZ1MABDh4AQAAAAAAAAAAAAMAAAD53gVyETAgISkODg4ONiUgMw4ODg4OGOogXmblx9SNdQRZ6qmGbK9Ea+1GzclnqYNvJblZum1UqTAMirsBNHKy9hq9EE6AGO1D2ohNebUA7IB7rp8PcgrPwGVzPxrxum2CB9wCOIAY7TuRpmZeP2x4V+ZKChSQ95eP7Vcg4nMjgDLYEBNwrnAYgJiDhvaQPu+LzUhtBQekxcK896fWWkLEDlRqooo+zKJqz47DLgs2YBgCnizDjNgL1wW2vRDSGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGOa58gveUiKEwKaVdk/p96gtoIJD+n/QtG54nL0ypatfD+BQrdQP1/zf5NoAzvPddBM5BQx7GOz2ZDwLNQykEKAYiVlcWcCSVJ0mMnwp41G7BNQlrwKiXNL9gBjtQ9qITXm1AIwWd3sgrRChajT1Ko8eK65x1oagcLJgGMsl5nXcRHYRuny6XKfx/gs5TxZw4/3rHPCB4UX+RL+/FreRrNwvyC0ALZ/+vl8dN4yAGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0g==",
"reference_base64": "T2dnUwACAAAAAAAAAAAAAAAAAAAAAGS5xGoBE09wdXNIZWFkAQE4AUAfAAAAAABPZ2dTAAAAAAAAAAAAAAAAAAABAAAASZW+VAEuT3B1c1RhZ3MGAAAAZmZtcGVnAQAAABQAAABlbmNvZGVyPUxhdmMgbGlib3B1c09nZ1MAAEC/AAAAAAAAAAAAAAIAAADhL4GbESoiHzMODg4OLiggNA8ODg4cGOA9fQJEOsAG4ZiC90q6E2WRsGLjIRCuNaf7lAuz0yTahU+lMAqu8OuQGOz2ZDwLNQykEKGwt8OxH+BJXGSvBItBnVF8FF2a92eM4BjtQ9qITXm1AIxQ7DMgrRChajUF27IeK65x1oagcQYYiyXmddxEdhG76Bhy4Kl6mrvBTVKEFp6n05W7muBNfM/lXzKTxFfRFpRwHKPsBS8QktAYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hhinizDjUOfWKLGLEbfzhb9vcjHf11RohdAZ2WWPb1l1aTX+ZId4wK7PA0sD4AY7DmIFL3jXBYqbwW8pIXxZnuU0OIUV34zmDLpZzazOB3mn7eli0iaGO1CN80nI8bGnOUrelalWs41A05rtjI4IyXgly1eMagY7G6Dy8IzQI0S2nLAQ+Ga956516XfC/XlWuOyiKngog9G4bacJpjFTy+5Cgz2R6mvzU6AGAgjgayA8fvyrLVuf7vxGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGCKeLMOM2AvXBpA703PGDUD8rrPtALNR8wXxeE9nZ1MABDh4AQAAAAAAAAAAAAMAAAD53gVyETAgISkODg4ONiUgMw4ODg4OGOogXmblx9SNdQRZ6qmGbK9Ea+1GzclnqYNvJblZum1UqTAMirsBNHKy9hq9EE6AGO1D2ohNebUA7IB7rp8PcgrPwGVzPxrxum2CB9wCOIAY7TuRpmZeP2x4V+ZKChSQ95eP7Vcg4nMjgDLYEBNwrnAYgJiDhvaQPu+LzUhtBQekxcK896fWWkLEDlRqooo+zKJqz47DLgs2YBgCnizDjNgL1wW2vRDSGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGOa58gveUiKEwKaVdk/p96gtoIJD+n/QtG54nL0ypatfD+BQrdQP1/zf5NoAzvPddBM5BQx7GOz2ZDwLNQykEKAYiVlcWcCSVJ0mMnwp41G7BNQlrwKiXNL9gBjtQ9qITXm1AIwWd3sgrRChajT1Ko8eK65x1oagcLJgGMsl5nXcRHYRuny6XKfx/gs5TxZw4/3rHPCB4UX+RL+/FreRrNwvyC0ALZ/+vl8dN4yAGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0hgCnizDjNgL1wW2vRDSGAKeLMOM2AvXBba9ENIYAp4sw4zYC9cFtr0Q0g=="
}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