Skip to content
HALOWERK

Tonwerk

sign overlay space

Samples the video at sample_fps on a 320 px wide grey copy. For each candidate corner a box of area_share of the picture (default 1/6, the minimum signer size Ofcom concluded in its review of signing on television) with aspect box_aspect and margin is tested in every sample: edge density (share of pixels whose gradient |dx|+|dy| exceeds 48) and motion (share of pixels changing by more than 20 grey levels from the previous sample). A sample is free when both stay below edge_max and.

POST https://ton.halowerk.com/v1/sign-overlay-space

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).
area_sharenumberNoSigner box area as share of the picture (default 1/6).
box_aspectnumberNoWidth divided by height of the signer box.
marginnumberNoDistance from the picture edges as share of the picture height.
positionsarrayNoCorners to test (default all four).
sample_fpsnumberNoSamples per second (lowered automatically for long ranges; the rate used is returned).
edge_maxnumberNoHighest edge density of a free box.
motion_maxnumberNoHighest share of moving pixels of a free box.
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)."
    },
    "area_share": {
      "type": "number",
      "minimum": 0.05,
      "maximum": 0.35,
      "default": 0.1667,
      "description": "Signer box area as share of the picture (default 1/6)."
    },
    "box_aspect": {
      "type": "number",
      "minimum": 0.4,
      "maximum": 1.5,
      "default": 0.75,
      "description": "Width divided by height of the signer box."
    },
    "margin": {
      "type": "number",
      "minimum": 0,
      "maximum": 0.1,
      "default": 0.03,
      "description": "Distance from the picture edges as share of the picture height."
    },
    "positions": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "bottom_right",
          "bottom_left",
          "top_right",
          "top_left"
        ]
      },
      "description": "Corners to test (default all four)."
    },
    "sample_fps": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 5,
      "default": 2,
      "description": "Samples per second (lowered automatically for long ranges; the rate used is returned)."
    },
    "edge_max": {
      "type": "number",
      "minimum": 0.001,
      "maximum": 0.5,
      "default": 0.04,
      "description": "Highest edge density of a free box."
    },
    "motion_max": {
      "type": "number",
      "minimum": 0.001,
      "maximum": 0.5,
      "default": 0.02,
      "description": "Highest share of moving pixels of a free box."
    }
  }
}

Open original schema

Published input example

{
  "video_url": "https://upload.wikimedia.org/wikipedia/commons/2/2c/Rotating_earth_%28large%29.gif",
  "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 โ†’