Skip to content
HALOWERK

Tonwerk

scrub sprites

Takes one thumbnail every interval_s (default: 1, 2, 5, 10, 15, 30 or 60 s so that at most 120 thumbnails result), scales it to the requested width with the display aspect ratio, tiles the thumbnails into sheets of columns x rows with ffmpeg 6.1 (tile filter) and writes a WebVTT track whose cues cover [k*interval, (k+1)*interval) and point to sprite_NNN.jpg#xywh=x,y,w,h (W3C Media Fragments 1.0), optionally prefixed with your CDN path. Exact mode decodes every frame; when that would exceed.

POST https://ton.halowerk.com/v1/scrub-sprites

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
video_base64stringNoVideo file 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 video file (at most 10 MiB; private, local and reserved addresses are refused).
interval_snumberNoSeconds between thumbnails (default: automatic, at most 120 thumbnails).
thumb_widthintegerNoThumbnail width in pixels (height follows the aspect ratio).
columnsintegerNoTiles per row.
rowsintegerNoMaximum rows per sheet.
formatstringNoImage format of the sheets.
qualityintegerNoImage quality 1-100.
url_prefixstringNoOptional prefix written before the sheet file names in the WebVTT track (for example https://cdn.example.com/video42/).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "video_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Video file 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 video file (at most 10 MiB; private, local and reserved addresses are refused)."
    },
    "interval_s": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 600,
      "description": "Seconds between thumbnails (default: automatic, at most 120 thumbnails)."
    },
    "thumb_width": {
      "type": "integer",
      "minimum": 64,
      "maximum": 480,
      "default": 160,
      "description": "Thumbnail width in pixels (height follows the aspect ratio)."
    },
    "columns": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Tiles per row."
    },
    "rows": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Maximum rows per sheet."
    },
    "format": {
      "type": "string",
      "enum": [
        "jpeg",
        "webp"
      ],
      "default": "jpeg",
      "description": "Image format of the sheets."
    },
    "quality": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 75,
      "description": "Image quality 1-100."
    },
    "url_prefix": {
      "type": "string",
      "maxLength": 500,
      "pattern": "^(https?://[^\\s\"<>]*|[A-Za-z0-9._~/-]*)$",
      "description": "Optional prefix written before the sheet file names in the WebVTT track (for example https://cdn.example.com/video42/)."
    }
  }
}

Open original schema

Published input example

{
  "video_url": "https://upload.wikimedia.org/wikipedia/commons/2/2c/Rotating_earth_%28large%29.gif",
  "interval_s": 0.5,
  "thumb_width": 96,
  "columns": 4
}

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