Measure against a named profile and get back only the lenses that question needs

Public http(s) URL to the audio file.

Path returned by /api/upload-url, for audio that has no public URL. Readable only by the key that uploaded it, and kept for about an hour so a follow-up question about the same file does not need a re-upload.

The preset. room: the reverberation time per octave band from one clap, balloon pop, impulse response or sweep (see roomSource); a recording that holds none of them is a 422 with the code room_not_measurable. chain: the gaps of digital silence inside the sound (lost packets). pitch: the pitch of a voice, how voiced the recording is and the harmonics-to-noise ratio. A measure that has not met its test yet (a beta that is not offered) is left out of the answer; the status of every measure is at https://audiolab.tools/lenses.

Include per-block lanes and curves alongside the single values.

Round the numbers to what the measurement is worth: dB and LUFS to 2 decimals, seconds to 3, shares to 3, Hz to 1. Same keys, same types, only fewer decimals. Off by default: without it you get the full precision, exactly as before. Supported on mixlab/analyze, voicelab/qa, signallab and analyze/profile.

Add one extra key, measureStatus, with the status (validated, proxy, beta, withdrawn, planned), the basis, how it works (dsp, model, mixed) and, where known, the margin of every measure in the answer. Off by default: without it the answer has no extra key. Supported on mixlab/analyze, voicelab/qa, signallab and analyze/profile.

Which model gives the content type (voice, music, mixed, noise, unknown) and its confidence. v1 is the first model and is the default until 15 January 2027; v2 is the new one, much better on speech and music in the tests (see the status of signal.contentType at https://audiolab.tools/lenses). The same keys and types in both, only the values differ, and with v2 the evidence list contains model:v2. From 15 January 2027 the default becomes v2 and v1 stays selectable until at least 15 April 2027. Supported on signallab and analyze/profile.

For the room profile: how the recording was made. clap: one clap (the default; the bands from 500 Hz up); balloon: one balloon pop (the same bands); impulse: the file already is an impulse response (every octave band from 125 Hz); sweep: the file holds the exponential sweep of the engine as the room returned it (every octave band from 125 Hz). Supported on analyze/profile with the room profile.

Which speech detector finds the speech in the recording; it decides speechRatio, speechSec, silenceSec, longSilences, segments and the measures that read the pauses. v1 is the first detector and is the default until 15 January 2027; k2 lets a phrase run on into its soft word starts and endings (by at most 100 ms per side) and was better on new speakers in the tests (frame F1 from 0.88 to 0.94 on clean audio and noise at 20 and 10 dB; see the status of voice.speechRatio at https://audiolab.tools/lenses). The same keys and types in both, only the values differ: with k2 the speech ratio reads about 5 to 14 points higher, everything that reads the speech frames or the pauses moves with it, signalToNoiseDb is corrected below 16 dB and reads about 4 to 5 dB lower at 10 dB noise and below (closer to the true ratio), and a pause measure is null when no pause frame is left; brightness, sibilanceRisk, noiseFloorDb and peakDb do not move (details: https://audiolab.tools/docs/start/changes-and-deprecation). From 15 January 2027 the default becomes k2 and v1 stays selectable until at least 15 April 2027. Supported on voicelab/qa, voicelab/segments and analyze/profile.

Speech segments found, before any cap.

Segments in this response. Lower than totalSegments when truncated.

Timeline regions found, before any cap.

Regions in this response. Lower than totalRegions when truncated.

True when segments or regions were capped at 500, keeping the longest. Everything that runs per event is cut with them, so a value never lands on the wrong segment.