Skip to content
HALOWERK

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
video_base64stringNoVideo 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_urlstringNoPublic http(s) URL of the video file (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).
renditionsarrayNoQuality levels (default: up to three steps of the built-in ladder at or below the source height).
segment_sintegerNoSegment length in seconds (every segment starts with a keyframe).
audio_kbpsintegerNoAAC 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."
    }
  }
}

Open original schema

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

All endpoints in this hub โ†’