Skip to content
HALOWERK

Bildwerk

ela analysis

Error level analysis (Krawetz 2007): the image is re-encoded once as JPEG at the chosen quality (libvips/libjpeg, Annex K tables) and the per-pixel error level is the largest absolute channel difference to the input. Error levels are averaged per grid cell. Because edges, colour edges and fine texture always show higher error levels, each cell is compared with a robust (Tukey bisquare) regression of error level on local gradient energy (largest channel gradient) and chroma strength (mean.

POST https://bild.halowerk.com/v1/ela-analysis

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoImage (JPEG, PNG, WebP, GIF, TIFF, AVIF) as base64 or data: URL, at most 10 MB. Give image_base64 or image_url.
image_urlstringNoPublic http(s) URL of the image (at most 10 MB).
qualityintegerNoJPEG quality used for the resave.
cell_sizeintegerNoGrid cell size in pixels (default: about 1/32 of the long side, at least 16, multiple of 8).
heatmapbooleanNoReturn an amplified error-level PNG (long side at most 512 px).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Image (JPEG, PNG, WebP, GIF, TIFF, AVIF) as base64 or data: URL, at most 10 MB. Give image_base64 or image_url."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the image (at most 10 MB)."
    },
    "quality": {
      "type": "integer",
      "minimum": 50,
      "maximum": 99,
      "default": 90,
      "description": "JPEG quality used for the resave."
    },
    "cell_size": {
      "type": "integer",
      "minimum": 8,
      "maximum": 128,
      "multipleOf": 8,
      "description": "Grid cell size in pixels (default: about 1/32 of the long side, at least 16, multiple of 8)."
    },
    "heatmap": {
      "type": "boolean",
      "default": true,
      "description": "Return an amplified error-level PNG (long side at most 512 px)."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "/9j/2wBDAAoHBwgHBgoICAgLCgoLDhgQDg0NDh0VFhEYIx8lJCIfIiEmKzcvJik0KSEiMEExNDk7Pj4+JS5ESUM8SDc9Pjv/2wBDAQoLCw4NDhwQEBw7KCIoOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozv/wAARCABIAGADASIAAhEBAxEB/8QAGgAAAgMBAQAAAAAAAAAAAAAAAwQAAgUGAf/EADkQAAEDAgQCBQkHBQAAAAAAAAEAAgMEEQUSITFBkRMiUWFxFDJCgaGxstHhIyRDUmKColNzwfDx/8QAGgEAAgMBAQAAAAAAAAAAAAAABAUBAwYCAP/EACQRAAICAgICAgIDAAAAAAAAAAECAAMEERIhEzEFFCJRcbHR/9oADAMBAAIRAxEAPwDOhgeTsr4hTFmFzG35fiC3YaEAC9kHHYWswae36fiCKFiDoStcvm4nE5SLWK8Nror7DQIV1WzbMeUtsTq6QfcKf+033BBdFfVFppGsoKfUH7JvuC8MoO3FA3XsvQnd9nEjUAYRsqTwHo722KbZ1jZPU9OH6FoN+BQYdydwFs+5XGhOfDO5Fa3RPVOGOimf0WwOjSUt0EzQ68burucugRY3Dkya7ew3+ytlEtmdwc7mrgSO0uR4r06Nqj3OofVsaLXWPjtcH4bM0HfL8QWbJiMzvypeaZ07CyRoLT4q5FO+4rrwVUgzKMpO11Zscsg0FgeJNk9HSQghxiF+GpR+jbxaPC5VN2VxPFIyWsCGhkc2CNu5DAPYmYOu4XJDeJshsgsAANky1nVAS173JkkKehNKnhpA0PEmfTUX15bpllTAy4DHb20/6scHLqCQmo5A9l+I3R9dHX5HuEDERRto9LPBUgXc5jhsSN0pJI6mu5wztdsQVQuIVHEGJ7HatLTwvwRKqV9GL8341LFLJ0ZlGb9PtXnTW9HmVcQEgDMbdl0aGkaDsuHIU6EGrpLDb9TN6O+6u2L1IgsF6HADQK9QYVsiVyW4KAKTTZGXtfVCFQ07ixSvIpKMdS5AzrvU1w0AL24F0ka3sb/JDfW9wHrS8KxPU4Wmze4+HA7FFhcGgkkAHvWS2pzAuBtwsr+VvPYfUtLiUWWryYajRGLDTDU1HzRt1LxzS01Wwttnbz3SE0r3sFwAhsaXHfbtR/1Qo7i/Mz1x2K6jwqGcHDmiNqWk+c3xukBE6+4RGw+xUfVTe9xBf8p5PxWBzFW1Jt3rq2YRRWv5MwW7kYYVRjanjH7fmvFdDqF/eRj6nFVIPRDsulTqNdF1WO0MEFI1zImC8gFw0DgVzzmN1s0ckstc8tERzi2q1exKPJ7UM3J3RN3KBl1Fawjyw9HAXsOmgKdZRE8Lo+EQh1O429P/AAFsRU7QNlpKWFdIMzmd8lYjsqzBqqLJEHW3db2IDY8oXT1NC2qhEecR2de4F/8Ad0lPg7WZR5Tf9n1S98+stxJ7mdvussUu8yAwBEj0PW7E4cOA/H/h9UpVxtpWZzNfW3m/VR50boGD0srOAJ1+ZrRqQEGWrhjBJkbp2FRRQDsbmh8SzExWtiqo+ha5wYDmJB3+ixDBETo5/MfJRRVeNWbZh1G1HEHqEZRxOPnP5hNR4XA70pOY+SiiPqpr16hLswHRmnR07KWPIwkgm9yU10uXjoooh8xyq6EUuoZtmDkrMovfZKCuMrna7KKLMVnleNwfOUDFbQ/X9iBfOTx8FkY2XOpGgf1B7iootJiIOQiHB7yU/mf/2Q==",
  "quality": 90,
  "heatmap": false
}

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 →