Skip to content
HALOWERK

Tonwerk

overlap interrupts

Merges each speaker's segments (gap ≤ 50 ms) and compares every pair of turns of different speakers. A turn that starts inside another speaker's turn and overlaps it by at least min_overlap_s is classified: interruption (the other speaker stops while the newcomer continues and the overlap is ≥ interruption_min_s), early_start (shorter overlap at a turn end), backchannel (short turn fully inside the other, ≤ backchannel_max_s), overlap (longer talk-over without taking the turn) or.

POST https://ton.halowerk.com/v1/overlap-interrupts

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
transcriptstring, object, arrayNoTranscript as WebVTT or SRT text (speakers from <v Name> voice tags or "Name:" prefixes), or JSON (text or object) with a list of segments, utterances, turns, cues or words carrying start, end, speaker and text – e.g. the output of medienwerk /v1/stt or /v1/diarize, Whisper, AssemblyAI or Deepgram.
segmentsarrayNoAlternative to transcript: segments with start/end in seconds, speaker and text.
time_unitstringNoUnit of start/end in JSON transcripts; auto treats integer values with a median segment length above 60 as milliseconds.
audio_base64stringNoStereo call recording (one party per channel) 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 stereo call recording (one party per channel) (at most 10 MiB; private and local addresses are refused).
channel_speakersarrayNoAudio mode: labels for left and right channel (default left, right).
crosstalk_dbnumberNoAudio mode: a channel counts as speaking only if it is at most this many dB below the other channel (crosstalk rule, default 15).
min_overlap_snumberNoShorter overlaps are ignored (default 0.2 s).
interruption_min_snumberNoMinimum overlap for an interruption; shorter overlaps at a turn end are early starts (default 0.5 s).
backchannel_max_snumberNoTurns up to this length fully inside another turn are backchannels (default 1 s).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "transcript": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "minLength": 1,
      "maxLength": 3000000,
      "description": "Transcript as WebVTT or SRT text (speakers from <v Name> voice tags or \"Name:\" prefixes), or JSON (text or object) with a list of segments, utterances, turns, cues or words carrying start, end, speaker and text – e.g. the output of medienwerk /v1/stt or /v1/diarize, Whisper, AssemblyAI or Deepgram."
    },
    "segments": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "start",
          "end",
          "text"
        ],
        "properties": {
          "start": {
            "type": "number",
            "minimum": 0,
            "maximum": 86400,
            "description": "Start time in seconds."
          },
          "end": {
            "type": "number",
            "minimum": 0,
            "maximum": 86400,
            "description": "End time in seconds."
          },
          "speaker": {
            "type": "string",
            "maxLength": 100,
            "description": "Speaker label as delivered by diarisation, e.g. \"A\", \"SPEAKER_00\" or \"Agent\"."
          },
          "text": {
            "type": "string",
            "maxLength": 5000,
            "description": "Text of the segment."
          }
        }
      },
      "description": "Alternative to transcript: segments with start/end in seconds, speaker and text."
    },
    "time_unit": {
      "type": "string",
      "enum": [
        "auto",
        "s",
        "ms"
      ],
      "default": "auto",
      "description": "Unit of start/end in JSON transcripts; auto treats integer values with a median segment length above 60 as milliseconds."
    },
    "audio_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Stereo call recording (one party per channel) 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 stereo call recording (one party per channel) (at most 10 MiB; private and local addresses are refused)."
    },
    "channel_speakers": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40
      },
      "description": "Audio mode: labels for left and right channel (default left, right)."
    },
    "crosstalk_db": {
      "type": "number",
      "minimum": 3,
      "maximum": 40,
      "description": "Audio mode: a channel counts as speaking only if it is at most this many dB below the other channel (crosstalk rule, default 15)."
    },
    "min_overlap_s": {
      "type": "number",
      "minimum": 0.05,
      "maximum": 3,
      "default": 0.2,
      "description": "Shorter overlaps are ignored (default 0.2 s)."
    },
    "interruption_min_s": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 5,
      "default": 0.5,
      "description": "Minimum overlap for an interruption; shorter overlaps at a turn end are early starts (default 0.5 s)."
    },
    "backchannel_max_s": {
      "type": "number",
      "minimum": 0.2,
      "maximum": 3,
      "default": 1,
      "description": "Turns up to this length fully inside another turn are backchannels (default 1 s)."
    }
  }
}

Open original schema

Published input example

{
  "segments": [
    {
      "start": 0,
      "end": 4,
      "speaker": "Agent",
      "text": "Your contract renews next month, and the price stays the same."
    },
    {
      "start": 3.1,
      "end": 6,
      "speaker": "Customer",
      "text": "Sorry, but I wanted to cancel."
    },
    {
      "start": 6.2,
      "end": 9,
      "speaker": "Agent",
      "text": "I understand, let me check that."
    },
    {
      "start": 7,
      "end": 7.4,
      "speaker": "Customer",
      "text": "Okay."
    }
  ]
}

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 →