Skip to content
HALOWERK

Tonwerk

slides from video

Samples the video at sample_fps on a 160 px wide grey image, splits it into runs without change (share of pixels changing by more than 24 grey levels at most change_threshold, against the previous sample and the run start) and keeps runs lasting at least min_stable_s. The last frame of each run represents the slide; runs whose frames match an earlier slide (64-bit DCT perceptual hash within 8 bits and pixel change within the threshold) are merged as repeated appearances. Slides are.

POST https://ton.halowerk.com/v1/slides-from-video

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
video_base64stringNoThe video 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 (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 900; default: to the end of the video).
sample_fpsnumberNoFrames analysed per second.
min_stable_snumberNoMinimum time a picture must stay unchanged to count as a slide.
change_thresholdnumberNoShare of pixels that must change to start a new slide.
image_widthintegerNoWidth of the slide images in the PDF (never larger than the video).
max_slidesintegerNoMaximum number of slides returned.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "video_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The video 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 (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": 900,
      "description": "Length of the analysed range in seconds (at most 900; default: to the end of the video)."
    },
    "sample_fps": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 2,
      "default": 1,
      "description": "Frames analysed per second."
    },
    "min_stable_s": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 60,
      "default": 2,
      "description": "Minimum time a picture must stay unchanged to count as a slide."
    },
    "change_threshold": {
      "type": "number",
      "minimum": 0.002,
      "maximum": 0.3,
      "default": 0.02,
      "description": "Share of pixels that must change to start a new slide."
    },
    "image_width": {
      "type": "integer",
      "minimum": 320,
      "maximum": 1920,
      "default": 1280,
      "description": "Width of the slide images in the PDF (never larger than the video)."
    },
    "max_slides": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "default": 40,
      "description": "Maximum number of slides returned."
    }
  }
}

Open original schema

Published input example

{
  "video_base64": "R0lGODlhMAAcAPcfMR1MeC58Mv///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////yH/C05FVFNDQVBFMi4wAwEAAAAh+QQEZAAfACwAAAAAMAAcAIEdTHgufDL///////8IWwAFCBxIsKDBgwgTKlzIsOFBABAjSpxIsaJFiwQvatzIEWLGjiBDAvgosuRFkiZTSkSpUqXDlzBjypxJs6bNmzhz6tzJs6fPn0CDCh1KtKjRo0iTKl3KtKnMgAAAIfkEBWQAAAAsLwAbAAEAAQAACAQAAQQEACH5BAVkAAAALC8AGwABAAEAAAgEAAEEBAAh+QQFZAAAACwCAAIALAAWAAAIWQAFCBxIsKDBgwgTKlzIsKHDhxAjSpxIsaLFhQAyatzIsaPHjyBDihxJsqTJkyhTqlzJsqXLlzBjypxJk2OAmzhz6tT5cqdPnz1/Cr0ZdOjPokZ3Ik2a82VAACH5BAVkAAAALC8AGwABAAEAAAgEAAEEBAAh+QQFZAAAACwvABsAAQABAAAIBAABBAQAIfkEBWQAAQAsAgACACwAFgAACFkAAQgcSLCgwYMIEypcyLChw4cQI0qcSLGixYUBMmrcyLGjx48gQ4ocSbKkyZMoU6pcybKly5cwY8qcSZOjgJs4c+rU+XKnT589fwq9GXToz6JGdyJNmvNlQAAh+QQFZAAAACwvABsAAQABAAAIBAABBAQAIfkEBWQAAAAsLwAbAAEAAQAACAQAAQQEADs=",
  "min_stable_s": 2,
  "image_width": 320
}

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 โ†’