Tonwerk
intro outro render
Each card is a full-frame ffmpeg 6.1 render: solid colour or linear two-colour gradient background, optional logo (PNG/JPEG/WebP, up to 22 % of the frame height, alpha kept), title in Liberation Sans Bold and subtitle in the accent colour (SIL OFL 1.1), centred and wrapped by measured text width to at most two lines each. Templates: fade (fade from black, text fades in), slide_up (text rises with quadratic ease-out while fading in) and wipe (an accent panel sweeps across in 0.9 s and reveals.
POST https://ton.halowerk.com/v1/intro-outro-renderInputs
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Title of the intro card (and of the outro unless outro_title is set). |
| subtitle | string | No | Subtitle of the intro card. |
| outro_title | string | No | Title of the outro card (default: title). |
| outro_subtitle | string | No | Subtitle of the outro card, for example a web address. |
| kind | string | No | Which cards to render. |
| template | string | No | Motion template. |
| card_s | number | No | Length of each card in seconds. |
| background_color | string | No | Background colour (gradient start) as #RRGGBB. |
| background_color2 | string | No | Optional second colour for a diagonal linear gradient. |
| accent_color | string | No | Accent colour (subtitle, wipe panel) as #RRGGBB. |
| text_color | string | No | Title colour as #RRGGBB. |
| logo_base64 | string | No | Logo image (optional) as base64 (PNG, JPEG or WebP; at most 10 MiB decoded; a data: URL prefix is accepted). |
| logo_url | string | No | Public http(s) URL of the logo image (optional) (at most 10 MiB; private, local and reserved addresses are refused). |
| video_base64 | string | No | Video to wrap with the cards (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 wrap with the cards (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 without a video. |
| height | integer | No | Frame height without a video. |
| fps | integer | No | Frame rate without a video. |
| 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": [
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Title of the intro card (and of the outro unless outro_title is set)."
},
"subtitle": {
"type": "string",
"maxLength": 120,
"description": "Subtitle of the intro card."
},
"outro_title": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Title of the outro card (default: title)."
},
"outro_subtitle": {
"type": "string",
"maxLength": 120,
"description": "Subtitle of the outro card, for example a web address."
},
"kind": {
"type": "string",
"enum": [
"intro",
"outro",
"both"
],
"default": "intro",
"description": "Which cards to render."
},
"template": {
"type": "string",
"enum": [
"fade",
"slide_up",
"wipe"
],
"default": "fade",
"description": "Motion template."
},
"card_s": {
"type": "number",
"minimum": 2,
"maximum": 8,
"default": 3,
"description": "Length of each card in seconds."
},
"background_color": {
"type": "string",
"pattern": "^#?[0-9A-Fa-f]{6}$",
"default": "#102040",
"description": "Background colour (gradient start) as #RRGGBB."
},
"background_color2": {
"type": "string",
"pattern": "^#?[0-9A-Fa-f]{6}$",
"description": "Optional second colour for a diagonal linear gradient."
},
"accent_color": {
"type": "string",
"pattern": "^#?[0-9A-Fa-f]{6}$",
"default": "#FBBF24",
"description": "Accent colour (subtitle, wipe panel) as #RRGGBB."
},
"text_color": {
"type": "string",
"pattern": "^#?[0-9A-Fa-f]{6}$",
"default": "#FFFFFF",
"description": "Title colour as #RRGGBB."
},
"logo_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000,
"description": "Logo image (optional) 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 logo image (optional) (at most 10 MiB; private, local and reserved addresses are refused)."
},
"video_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000,
"description": "Video to wrap with the cards (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 wrap with the cards (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": 1280,
"description": "Frame width without a video."
},
"height": {
"type": "integer",
"minimum": 180,
"maximum": 1080,
"multipleOf": 2,
"default": 720,
"description": "Frame height without a video."
},
"fps": {
"type": "integer",
"enum": [
24,
25,
30,
50,
60
],
"default": 25,
"description": "Frame rate without a video."
},
"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
{
"title": "Welcome",
"subtitle": "Episode 1",
"width": 640,
"height": 360,
"card_s": 2
}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