Skip to content
HALOWERK

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-score

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
audio_base64stringNoDegraded 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_urlstringNoPublic http(s) URL of the degraded speech recording (e.g. announcement as heard) (at most 10 MiB; private and local addresses are refused).
reference_base64stringNoClean reference speech as base64 (at most 10 MiB decoded), same content as the recording.
reference_urlstringNoPublic http(s) URL of the clean reference speech (at most 10 MiB).
alignbooleanNoAlign the recording to the reference by cross-correlation before scoring.
max_delay_snumberNoLargest 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."
    }
  }
}

Open original schema

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

All endpoints in this hub →