Skip to content
HALOWERK

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-render

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
titlestringYesTitle of the intro card (and of the outro unless outro_title is set).
subtitlestringNoSubtitle of the intro card.
outro_titlestringNoTitle of the outro card (default: title).
outro_subtitlestringNoSubtitle of the outro card, for example a web address.
kindstringNoWhich cards to render.
templatestringNoMotion template.
card_snumberNoLength of each card in seconds.
background_colorstringNoBackground colour (gradient start) as #RRGGBB.
background_color2stringNoOptional second colour for a diagonal linear gradient.
accent_colorstringNoAccent colour (subtitle, wipe panel) as #RRGGBB.
text_colorstringNoTitle colour as #RRGGBB.
logo_base64stringNoLogo image (optional) as base64 (PNG, JPEG or WebP; at most 10 MiB decoded; a data: URL prefix is accepted).
logo_urlstringNoPublic http(s) URL of the logo image (optional) (at most 10 MiB; private, local and reserved addresses are refused).
video_base64stringNoVideo 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_urlstringNoPublic http(s) URL of the video to wrap with the cards (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 without a video.
heightintegerNoFrame height without a video.
fpsintegerNoFrame rate without a video.
qualitystringNoH.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)."
    }
  }
}

Open original schema

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

All endpoints in this hub โ†’