Skip to content
HALOWERK

Tonwerk

av sync offset

Decodes every frame at 64 px width and finds visual events as sudden rises of mean luma (a flash or white frame); finds audio events as onsets in a 1 ms energy envelope (rise above peak −20 dB after at least 60 ms below peak −30 dB). Each visual event is paired with the nearest audio onset within ±max_offset_ms; the median of the pairs is the offset, their spread the consistency. Offsets are given both as audio_delay_ms (positive: sound comes after the picture) and as audio_lead_ms in the.

POST https://ton.halowerk.com/v1/av-sync-offset

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
video_base64stringNoThe video with audio as base64 (MP4/MOV, WebM/MKV, AVI, MPEG-TS, MPEG-PS, FLV, Ogg or animated GIF; at most 10 MiB decoded; a data: URL prefix is accepted).
video_urlstringNoPublic http(s) URL of the the video with audio (at most 10 MiB; private, local and reserved addresses are refused).
start_snumberNoStart of the analysed range in seconds.
duration_snumberNoLength of the analysed range in seconds (at most 120; default: to the end of the video).
max_offset_msintegerNoLargest offset searched, in both directions.
min_luma_riseintegerNoSmallest rise of mean luma (0–255) from one frame to the next that counts as a visual event.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "video_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The video with audio as base64 (MP4/MOV, WebM/MKV, AVI, MPEG-TS, MPEG-PS, FLV, Ogg or animated GIF; at most 10 MiB decoded; a data: URL prefix is accepted)."
    },
    "video_url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https?://",
      "maxLength": 2048,
      "description": "Public http(s) URL of the the video with audio (at most 10 MiB; private, local and reserved addresses are refused)."
    },
    "start_s": {
      "type": "number",
      "minimum": 0,
      "maximum": 36000,
      "default": 0,
      "description": "Start of the analysed range in seconds."
    },
    "duration_s": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 120,
      "description": "Length of the analysed range in seconds (at most 120; default: to the end of the video)."
    },
    "max_offset_ms": {
      "type": "integer",
      "minimum": 40,
      "maximum": 2000,
      "default": 500,
      "description": "Largest offset searched, in both directions."
    },
    "min_luma_rise": {
      "type": "integer",
      "minimum": 5,
      "maximum": 200,
      "default": 40,
      "description": "Smallest rise of mean luma (0–255) from one frame to the next that counts as a visual event."
    }
  }
}

Open original schema

Published input example

{
  "video_base64": "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",
  "max_offset_ms": 400
}

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 →