Skip to content
HALOWERK

Bildwerk

animation to video

Reads frame count, size, loop count and total duration from the file structure, then encodes with ffmpeg 6.1 in a child process under prlimit (no shell, empty environment, only the file protocol): GIF and APNG are demuxed natively, animated WebP (which ffmpeg 6.1 cannot decode) is decoded by libvips and re-wrapped losslessly as APNG with the exact frame delays (at most 120 million decoded frame-pixels). Frame timestamps are passed through (variable frame rate) unless fps is set; GIF delays.

POST https://bild.halowerk.com/v1/animation-to-video

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
animation_base64stringNoThe animation (GIF, APNG or animated WebP) as base64 or data: URL, at most 10 MB decoded. Give either animation_base64 or animation_url.
animation_urlstringNoPublic http(s) URL of the animation (GIF, APNG or animated WebP), fetched once (at most 10 MB). Private and local addresses are refused.
formatstringNo
crfintegerNoConstant rate factor (lower = better); default 23 for MP4, 32 for WebM.
max_widthintegerNo
fpsintegerNoOptional constant frame rate; default keeps the original timing.
backgroundstringNoHex colour under transparent pixels.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "animation_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The animation (GIF, APNG or animated WebP) as base64 or data: URL, at most 10 MB decoded. Give either animation_base64 or animation_url."
    },
    "animation_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the animation (GIF, APNG or animated WebP), fetched once (at most 10 MB). Private and local addresses are refused."
    },
    "format": {
      "type": "string",
      "enum": [
        "mp4",
        "webm"
      ],
      "default": "mp4"
    },
    "crf": {
      "type": "integer",
      "minimum": 10,
      "maximum": 50,
      "description": "Constant rate factor (lower = better); default 23 for MP4, 32 for WebM."
    },
    "max_width": {
      "type": "integer",
      "minimum": 16,
      "maximum": 1920,
      "default": 1280
    },
    "fps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "Optional constant frame rate; default keeps the original timing."
    },
    "background": {
      "type": "string",
      "maxLength": 7,
      "default": "#ffffff",
      "description": "Hex colour under transparent pixels."
    }
  }
}

Open original schema

Published input example

{
  "animation_url": "https://upload.wikimedia.org/wikipedia/commons/2/2c/Rotating_earth_%28large%29.gif",
  "format": "mp4"
}

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 →