Skip to content
HALOWERK

Tonwerk

logo screen time

The logo (PNG, JPEG or WebP, cropped to its opaque pixels) is turned into grey templates for widths between min_logo_width and max_logo_width of the frame width in steps of 1.2x. Only the opaque pixels are compared, so transparent corners or gaps show whatever background the video has. Each sample (sample_fps, at most 60 samples per call) is searched at 160 px width with zero-mean normalised cross-correlation over all positions and scales; the five best candidates are refined at 320 px width.

POST https://ton.halowerk.com/v1/logo-screen-time

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 600; default: to the end of the video).
logo_base64stringNoThe logo image as base64 (PNG, JPEG or WebP; at most 10 MiB decoded; a data: URL prefix is accepted).
logo_urlstringNoPublic http(s) URL of the the logo image (at most 10 MiB; private, local and reserved addresses are refused).
sample_fpsnumberNoFrames searched per second (at most 60 samples per call).
min_scorenumberNoMinimum normalised cross-correlation (0 to 1) of the refined match for a detection.
min_logo_widthnumberNoSmallest logo width searched, as a share of the frame width.
max_logo_widthnumberNoLargest logo width searched, as a share of the frame width.
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": 600,
      "description": "Length of the analysed range in seconds (at most 600; default: to the end of the video)."
    },
    "logo_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The logo image as base64 (PNG, JPEG or WebP; at most 10 MiB decoded; a data: URL prefix is accepted)."
    },
    "logo_url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https?://",
      "maxLength": 2048,
      "description": "Public http(s) URL of the the logo image (at most 10 MiB; private, local and reserved addresses are refused)."
    },
    "sample_fps": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 4,
      "default": 1,
      "description": "Frames searched per second (at most 60 samples per call)."
    },
    "min_score": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 0.99,
      "default": 0.85,
      "description": "Minimum normalised cross-correlation (0 to 1) of the refined match for a detection."
    },
    "min_logo_width": {
      "type": "number",
      "minimum": 0.04,
      "maximum": 0.8,
      "default": 0.05,
      "description": "Smallest logo width searched, as a share of the frame width."
    },
    "max_logo_width": {
      "type": "number",
      "minimum": 0.05,
      "maximum": 0.9,
      "default": 0.4,
      "description": "Largest logo width searched, as a share of the frame width."
    }
  }
}

Open original schema

Published input example

{
  "video_url": "https://upload.wikimedia.org/wikipedia/commons/2/2c/Rotating_earth_%28large%29.gif",
  "logo_base64": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAMCAIAAAD3UuoiAAAACXBIWXMAAAABAAAAAQBPJcTWAAAAK0lEQVR42mNgMJpOEP0nAjAMhEEHDmFHpBp0moEBKxo1aDAbRLXop1PKBgDJ265QGnuMIAAAAABJRU5ErkJggg==",
  "sample_fps": 1
}

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