Skip to content
HALOWERK

Tonwerk

subtitle display safe area plan

Return caption safe-area violations and corner placement candidates avoiding supplied exclusion boxes. Supplied data only.

POST https://ton.halowerk.com/v1/subtitle-display-safe-area-plan

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
widthintegerYes
heightintegerYes
captionarrayYes
exclusionsarrayYes
marginintegerYes
Show full input schema
{
  "type": "object",
  "properties": {
    "width": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7680
    },
    "height": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7680
    },
    "caption": {
      "type": "array",
      "items": {
        "type": "number",
        "minimum": -10000,
        "maximum": 10000
      },
      "minItems": 4,
      "maxItems": 4
    },
    "exclusions": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number",
          "minimum": -10000,
          "maximum": 10000
        },
        "minItems": 4,
        "maxItems": 4
      },
      "maxItems": 20,
      "minItems": 0
    },
    "margin": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000
    }
  },
  "required": [
    "width",
    "height",
    "caption",
    "exclusions",
    "margin"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "width": 1920,
  "height": 1080,
  "caption": [
    100,
    900,
    1720,
    120
  ],
  "exclusions": [
    [
      1500,
      850,
      300,
      200
    ]
  ],
  "margin": 40
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-18 UTC.

More endpoints in this hub

All endpoints in this hub โ†’