Skip to content
HALOWERK

Tonwerk

lower third render

Three templates: bar (accent stripe plus semi-transparent box), box (name on an accent box, subtitle on a second box) and minimal (text with drop shadow and accent underline). Sizes scale with the frame height (name 52 px and subtitle 34 px at 1080p, Liberation Sans Bold/Regular, SIL OFL 1.1); text widths are measured with the font metrics, the graphic is placed inside the EBU R 95 graphics-safe area (5 % from the left/right edge, bottom 10 %) and fonts shrink down to 70 % before a too-long.

POST https://ton.halowerk.com/v1/lower-third-render

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
namestringYesMain line, for example the person name.
subtitlestringNoSecond line, for example role or company.
stylestringNoTemplate.
positionstringNoHorizontal position inside the safe area.
accent_colorstringNoAccent colour (stripe, name box or underline) as #RRGGBB.
text_colorstringNoText colour as #RRGGBB.
subtitle_colorstringNoSubtitle colour (default: text_color).
box_colorstringNoBox colour as #RRGGBB.
box_opacitynumberNoOpacity of the (subtitle) box.
animationstringNoIn/out animation.
transition_snumberNoLength of the in and out animation.
in_snumberNoTime at which the graphic appears (default 1 s with a video, 0 s standalone).
hold_snumberNoTime the graphic is on screen, animations included.
video_base64stringNoVideo to burn the lower third into (optional) 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 to burn the lower third into (optional) (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 60; default: to the end of the video).
widthintegerNoFrame width of the standalone overlay.
heightintegerNoFrame height of the standalone overlay.
fpsintegerNoFrame rate of the standalone overlay.
formatstringNoContainer of the standalone overlay: webm (VP9 with alpha, small) or mov (QuickTime Animation, lossless ARGB).
qualitystringNoH.264 quality: small (CRF 28), balanced (CRF 23) or high (CRF 19).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "pattern": "^[^\\n\\r\\t]+$",
      "description": "Main line, for example the person name."
    },
    "subtitle": {
      "type": "string",
      "maxLength": 80,
      "pattern": "^[^\\n\\r\\t]*$",
      "description": "Second line, for example role or company."
    },
    "style": {
      "type": "string",
      "enum": [
        "bar",
        "box",
        "minimal"
      ],
      "default": "bar",
      "description": "Template."
    },
    "position": {
      "type": "string",
      "enum": [
        "left",
        "center",
        "right"
      ],
      "default": "left",
      "description": "Horizontal position inside the safe area."
    },
    "accent_color": {
      "type": "string",
      "pattern": "^#?[0-9A-Fa-f]{6}$",
      "default": "#E11D48",
      "description": "Accent colour (stripe, name box or underline) as #RRGGBB."
    },
    "text_color": {
      "type": "string",
      "pattern": "^#?[0-9A-Fa-f]{6}$",
      "default": "#FFFFFF",
      "description": "Text colour as #RRGGBB."
    },
    "subtitle_color": {
      "type": "string",
      "pattern": "^#?[0-9A-Fa-f]{6}$",
      "description": "Subtitle colour (default: text_color)."
    },
    "box_color": {
      "type": "string",
      "pattern": "^#?[0-9A-Fa-f]{6}$",
      "default": "#111827",
      "description": "Box colour as #RRGGBB."
    },
    "box_opacity": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.85,
      "description": "Opacity of the (subtitle) box."
    },
    "animation": {
      "type": "string",
      "enum": [
        "fade",
        "slide",
        "none"
      ],
      "default": "slide",
      "description": "In/out animation."
    },
    "transition_s": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1.5,
      "default": 0.4,
      "description": "Length of the in and out animation."
    },
    "in_s": {
      "type": "number",
      "minimum": 0,
      "maximum": 3600,
      "description": "Time at which the graphic appears (default 1 s with a video, 0 s standalone)."
    },
    "hold_s": {
      "type": "number",
      "minimum": 1,
      "maximum": 30,
      "default": 5,
      "description": "Time the graphic is on screen, animations included."
    },
    "video_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Video to burn the lower third into (optional) 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 to burn the lower third into (optional) (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": 60,
      "description": "Length of the analysed range in seconds (at most 60; default: to the end of the video)."
    },
    "width": {
      "type": "integer",
      "minimum": 320,
      "maximum": 1920,
      "multipleOf": 2,
      "default": 1920,
      "description": "Frame width of the standalone overlay."
    },
    "height": {
      "type": "integer",
      "minimum": 180,
      "maximum": 1080,
      "multipleOf": 2,
      "default": 1080,
      "description": "Frame height of the standalone overlay."
    },
    "fps": {
      "type": "integer",
      "enum": [
        24,
        25,
        30,
        50,
        60
      ],
      "default": 25,
      "description": "Frame rate of the standalone overlay."
    },
    "format": {
      "type": "string",
      "enum": [
        "webm",
        "mov"
      ],
      "default": "webm",
      "description": "Container of the standalone overlay: webm (VP9 with alpha, small) or mov (QuickTime Animation, lossless ARGB)."
    },
    "quality": {
      "type": "string",
      "enum": [
        "small",
        "balanced",
        "high"
      ],
      "default": "balanced",
      "description": "H.264 quality: small (CRF 28), balanced (CRF 23) or high (CRF 19)."
    }
  }
}

Open original schema

Published input example

{
  "name": "Research department",
  "subtitle": "Head of Research",
  "width": 640,
  "height": 360,
  "hold_s": 3
}

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