Skip to content
HALOWERK

Bildwerk

thermal read

FLIR radiometric JPEG: APP1 FLIR chunks joined, FFF records read as in ExifTool FLIR.pm (CameraInfo with emissivity, distance, temperatures, humidity, Planck R1/R2/B/F/O, atmosphere constants; RawData 16-bit raw or PNG). Per-pixel Planck inversion with the FLIR atmosphere model (ExifTool forum 4898); the FLIR parameters can be overridden. 16-bit grey PNG/TIFF exports need a linear scale.

POST https://bild.halowerk.com/v1/thermal-read

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoImage (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB.
image_urlstringNoOr a public image URL.
emissivitynumberNo
reflected_temperature_cnumberNo
atmospheric_temperature_cnumberNo
object_distance_mnumberNo
relative_humidity_percentnumberNo
linear_presetstringNo16-bit scale: cK = v/100 − 273.15, dK = v/10 − 273.15, c°C = v/100.
linear_scalenumberNo°C = v · scale + offset.
linear_offsetnumberNoOffset in °C.
pointsarrayNoSpot pixels (thermal raster).
boxesarrayNoBoxes for min/max/mean.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Image (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Or a public image URL."
    },
    "emissivity": {
      "type": "number",
      "minimum": 0.05,
      "maximum": 1
    },
    "reflected_temperature_c": {
      "type": "number",
      "minimum": -100,
      "maximum": 500
    },
    "atmospheric_temperature_c": {
      "type": "number",
      "minimum": -60,
      "maximum": 100
    },
    "object_distance_m": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000
    },
    "relative_humidity_percent": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "linear_preset": {
      "type": "string",
      "enum": [
        "centikelvin",
        "decikelvin",
        "centicelsius"
      ],
      "description": "16-bit scale: cK = v/100 − 273.15, dK = v/10 − 273.15, c°C = v/100."
    },
    "linear_scale": {
      "type": "number",
      "description": "°C = v · scale + offset."
    },
    "linear_offset": {
      "type": "number",
      "description": "Offset in °C."
    },
    "points": {
      "type": "array",
      "maxItems": 50,
      "description": "Spot pixels (thermal raster).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "x",
          "y"
        ],
        "properties": {
          "x": {
            "type": "integer",
            "minimum": 0
          },
          "y": {
            "type": "integer",
            "minimum": 0
          }
        }
      }
    },
    "boxes": {
      "type": "array",
      "maxItems": 20,
      "description": "Boxes for min/max/mean.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "x",
          "y",
          "width",
          "height"
        ],
        "properties": {
          "x": {
            "type": "integer",
            "minimum": 0
          },
          "y": {
            "type": "integer",
            "minimum": 0
          },
          "width": {
            "type": "integer",
            "minimum": 1
          },
          "height": {
            "type": "integer",
            "minimum": 1
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAYEAAAAADuqHyrAAAAI0lEQVR42mMoaqYMMowaMGoAzQyoiIfBkWvAaDoYNYDuBgAAsHzcx2dHc6QAAAAASUVORK5CYII=",
  "linear_preset": "centikelvin",
  "points": [
    {
      "x": 12,
      "y": 11
    }
  ]
}

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 →