Tonwerk
hls package
Encodes up to four renditions in one ffmpeg 6.1 pass (libx264 high profile, constrained VBR with maxrate 1.1x and buffer 2x the target, closed GOPs with a keyframe at every segment boundary) plus one AAC stereo audio rendition, and segments them as fragmented MP4 (CMAF) with the DASH muxer. The MPD comes from ffmpeg (SegmentTimeline; bandwidth replaced by the measured peak segment bit rate). The HLS playlists are written by this service after RFC 8216: VERSION 6 (EXT-X-MAP), VOD,.
POST https://ton.halowerk.com/v1/hls-packageInputs
| Field | Type | Required | Description |
|---|---|---|---|
| video_base64 | string | No | Video file 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 file (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). |
| renditions | array | No | Quality levels (default: up to three steps of the built-in ladder at or below the source height). |
| segment_s | integer | No | Segment length in seconds (every segment starts with a keyframe). |
| audio_kbps | integer | No | AAC bit rate of the audio rendition. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"video_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000,
"description": "Video file 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 file (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)."
},
"renditions": {
"type": "array",
"minItems": 1,
"maxItems": 4,
"description": "Quality levels (default: up to three steps of the built-in ladder at or below the source height).",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"height",
"video_kbps"
],
"properties": {
"height": {
"type": "integer",
"minimum": 120,
"maximum": 1080,
"description": "Frame height in pixels (width follows the display aspect ratio)."
},
"video_kbps": {
"type": "integer",
"minimum": 100,
"maximum": 8000,
"description": "Target video bit rate in kbit/s."
}
}
}
},
"segment_s": {
"type": "integer",
"minimum": 2,
"maximum": 10,
"default": 4,
"description": "Segment length in seconds (every segment starts with a keyframe)."
},
"audio_kbps": {
"type": "integer",
"minimum": 48,
"maximum": 256,
"default": 128,
"description": "AAC bit rate of the audio rendition."
}
}
}Published input example
{
"video_url": "https://upload.wikimedia.org/wikipedia/commons/2/2c/Rotating_earth_%28large%29.gif",
"segment_s": 2,
"renditions": [
{
"height": 360,
"video_kbps": 700
},
{
"height": 240,
"video_kbps": 400
}
]
}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