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-renderInputs
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Main line, for example the person name. |
| subtitle | string | No | Second line, for example role or company. |
| style | string | No | Template. |
| position | string | No | Horizontal position inside the safe area. |
| accent_color | string | No | Accent colour (stripe, name box or underline) as #RRGGBB. |
| text_color | string | No | Text colour as #RRGGBB. |
| subtitle_color | string | No | Subtitle colour (default: text_color). |
| box_color | string | No | Box colour as #RRGGBB. |
| box_opacity | number | No | Opacity of the (subtitle) box. |
| animation | string | No | In/out animation. |
| transition_s | number | No | Length of the in and out animation. |
| in_s | number | No | Time at which the graphic appears (default 1 s with a video, 0 s standalone). |
| hold_s | number | No | Time the graphic is on screen, animations included. |
| video_base64 | string | No | 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 | string | No | 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 | number | No | Start of the analysed range in seconds. |
| duration_s | number | No | Length of the analysed range in seconds (at most 60; default: to the end of the video). |
| width | integer | No | Frame width of the standalone overlay. |
| height | integer | No | Frame height of the standalone overlay. |
| fps | integer | No | Frame rate of the standalone overlay. |
| format | string | No | Container of the standalone overlay: webm (VP9 with alpha, small) or mov (QuickTime Animation, lossless ARGB). |
| quality | string | No | H.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)."
}
}
}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
- Tonwerk0.01 USDC
accessible transcript html
POSThttps://ton.halowerk.com/v1/accessible-transcript-htmlParses SRT or WebVTT (voice tags <v Name>, "NAME:" prefixes and ">>" speaker changes) or a segments array, merges consecutive cues of the same speaker into turns (a new paragraph after a pause longer than paragraph_gap_s), and writes semant
- Tonwerk0.01 USDC
ad disclosure audio
POSThttps://ton.halowerk.com/v1/ad-disclosure-audioDecodes the complete supplied clip to mono 16 kHz using resource-limited ffmpeg, checks for speech with Silero VAD v6.2 (MIT), and transcribes locally with the pinned Whisper base ONNX model (MIT / Apache-2.0). Conservative English phrase r
- Tonwerk0.005 USDC
ad insertion markers
POSThttps://ton.halowerk.com/v1/ad-insertion-markersRuns ffmpeg 6.1 silencedetect on the episode audio (base64 or URL, at most 10 MiB) and builds mid-roll candidates from internal silences and from Podcasting 2.0 chapter boundaries (a boundary inside a silence or snapped to the nearest silen