Skip to content
HALOWERK

Tonwerk

stream loudness log

Measures a recording of up to 600 s (for example a stream dump) with the ffmpeg ebur128 filter (ITU-R BS.1770 K-weighting, 400 ms momentary and 3 s short-term loudness every 100 ms, true peak by oversampling). For each interval of interval_s seconds it computes the gated loudness of the 400 ms blocks inside the interval with the BS.1770 gates (absolute −70 LUFS, relative −10 LU), the maximum momentary and short-term loudness and the maximum true peak, and flags intervals outside target_lufs.

POST https://ton.halowerk.com/v1/stream-loudness-log

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
audio_base64stringNoRecorded stream excerpt, at most 600 s, as base64 (max 10 MiB): WAV, FLAC, MP3, AAC/M4A, Ogg/Opus, WebM and more.
audio_urlstringNoInstead of base64: public http(s) URL of the file (max 10 MiB).
interval_snumberNoLength of each log interval in seconds (default 10).
target_lufsnumberNoTarget loudness (default −23, EBU R 128; streaming platforms often −14 or −16).
tolerance_lunumberNoAllowed deviation per interval (default ±1 LU).
max_true_peak_dbtpnumberNoTrue-peak limit (default −1 dBTP).
silence_lufsnumberNoIntervals quieter than this are flagged silent instead of too_quiet (default −50 LUFS).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "audio_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Recorded stream excerpt, at most 600 s, as base64 (max 10 MiB): WAV, FLAC, MP3, AAC/M4A, Ogg/Opus, WebM and more."
    },
    "audio_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Instead of base64: public http(s) URL of the file (max 10 MiB)."
    },
    "interval_s": {
      "type": "number",
      "minimum": 1,
      "maximum": 300,
      "default": 10,
      "description": "Length of each log interval in seconds (default 10)."
    },
    "target_lufs": {
      "type": "number",
      "minimum": -40,
      "maximum": -5,
      "default": -23,
      "description": "Target loudness (default −23, EBU R 128; streaming platforms often −14 or −16)."
    },
    "tolerance_lu": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 10,
      "default": 1,
      "description": "Allowed deviation per interval (default ±1 LU)."
    },
    "max_true_peak_dbtp": {
      "type": "number",
      "minimum": -10,
      "maximum": 0,
      "default": -1,
      "description": "True-peak limit (default −1 dBTP)."
    },
    "silence_lufs": {
      "type": "number",
      "minimum": -70,
      "maximum": -30,
      "default": -50,
      "description": "Intervals quieter than this are flagged silent instead of too_quiet (default −50 LUFS)."
    }
  }
}

Open original schema

Published input example

{
  "audio_base64": "T2dnUwACAAAAAAAAAAAAAAAAAAAAAEkq9qABE09wdXNIZWFkAQE4AYA+AAAAAABPZ2dTAAAAAAAAAAAAAAAAAAABAAAASZW+VAEuT3B1c1RhZ3MGAAAAZmZtcGVnAQAAABQAAABlbmNvZGVyPUxhdmMgbGlib3B1c09nZ1MAAIC7AAAAAAAAAAAAAAIAAACoiJ8nMgcGBgYGBgYGBgYNDgoLCQoLCw8PDw4PEw4QEA8QERIPDxAOEhIUEg8ODhEQDhATExIPCAvmOyOrYAgIrLMOxggIrLMOxggIrLMOxggIrLMOxggIrLMOxggIrLMOxggIrLMOxggIrLMOxggIrLMOxgiAB1QL4XdTndjw8+AIh7TGOYLHIp5+o7X+QAiA2kdqErhNcLMIJIU4NjvBOHv+gAghcgNf9XiQwAghfxWNcINJZ4AIIeJ/ksZ60oubgAgh96eUvMGiRrojCIdY4RJmI0T1wRNaf9NACIugiYo+qZAE8VZGYDbOCI9tEhvQylACHw72YbAOCIQbfagpBJx2ontMf8AIhHdONCQ/u/deMkcLOuQItkzKTr7z8+iZVS2wPUPsnhTACLej4lLZSeJoLVfcRBIIty6aa+AP65hWYKG25lPWCLezHN5lA20esqbfKEwnwAi16g3LcJA7jGGwCGlKegi29SbiOAy8Y1Pl1VjSx0AIuP4D0o5jpd8+3neeHzoRDgi6dpY0xSprysr+a6XtlWC2iQi7+xNBjv+LxdCnei+ugAi8Ju1ZhqBH5+vTCr2Iogi79EmSSf27Ailw0N0Bm2AIu0DWwMkagmFX+xfIQgi5Se4SF45JVeXHnAGIS21lgAi2lCk68RY2+S77jWlAaw1KgAiwGD2j6X3p90WzHpVapWrbIoxYCLEH0J7Nf08gS5R/tv1BGZ9ECLwIWBW4EPSN14ENLa59CLx6LcALbyw4sQDl7sAIvHa/jjFBJ1ktAMgcmgi8bCccVMYdEYY4Fhpfy0vQCLxVQKttUVFXONIS/iFIcAi8SGifeOPthT7QHukgCLxbo52RzWnaQuBUf0ehSAi8VHlA9dJIjXASDjSFFoXzgjAIvFp2HTS9R2xKvMbB4TYciqWQCLvtFC/4Oqg3U4xaVcjEHMiACLefshPQtRSBKVqY7+KAT2dnUwAEuAcBAAAAAAAAAAAAAwAAANWpGI4VEA0NCgoLCgkLCwoOBgYGBgYGBgYGCLTHHzJTX3d++HfOsz+YHAivy+GEdPCM6Cy8APEIkBt/onLGh7gK9FhACDpNddtjsfQbIAgFqwPp0nj4OVAINExWotlyAg71sQgpSyOME2T81sAIJRz1EahEs+AIJJbvVK0XCGFfUgge0vMWcWxRnnGACBgqNvqBxfglzAgLBQuIweTkPD0rov1QCAissw7GCAissw7GCAissw7GCAissw7GCAissw7GCAissw7GCAissw7GCAissw7GCAissw7G",
  "interval_s": 1,
  "target_lufs": -16
}

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 →