Bildwerk
meter reading
Crops the region, scales the digits to OCR height and reads them with Tesseract 5.3.4 limited to 0–9: plain, inverted and, with a region, digits isolated as connected components (Otsu, both polarities, not touching the window edge) to drop drum frames. Adjacent words are joined; the run with digits_total digits (else the longest, most confident) wins. decimals splits off decimal places; previous_reading gives consumption and a roll-over hint.
POST https://bild.halowerk.com/v1/meter-readingInputs
| Field | Type | Required | Description |
|---|---|---|---|
| image_base64 | string | No | Image (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB. |
| image_url | string | No | Or a public image URL. |
| region | object | No | Box around the counter drums (recommended). |
| meter_type | string | No | Sets the default unit. |
| unit | string | No | Register unit (default by meter_type). |
| digits_total | integer | No | All digits incl. decimals, if known. |
| decimals | integer | No | Digits after the decimal point (often red). |
| previous_reading | number | No | For consumption and plausibility. |
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."
},
"region": {
"type": "object",
"additionalProperties": false,
"required": [
"x",
"y",
"width",
"height"
],
"description": "Box around the counter drums (recommended).",
"properties": {
"x": {
"type": "integer",
"minimum": 0
},
"y": {
"type": "integer",
"minimum": 0
},
"width": {
"type": "integer",
"minimum": 4
},
"height": {
"type": "integer",
"minimum": 4
}
}
},
"meter_type": {
"type": "string",
"enum": [
"electricity",
"gas",
"water",
"heat",
"other"
],
"default": "other",
"description": "Sets the default unit."
},
"unit": {
"type": "string",
"maxLength": 10,
"description": "Register unit (default by meter_type)."
},
"digits_total": {
"type": "integer",
"minimum": 3,
"maximum": 12,
"description": "All digits incl. decimals, if known."
},
"decimals": {
"type": "integer",
"minimum": 0,
"maximum": 4,
"default": 0,
"description": "Digits after the decimal point (often red)."
},
"previous_reading": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000,
"description": "For consumption and plausibility."
}
}
}Published input example
{
"image_base64": "iVBORw0KGgoAAAANSUhEUgAAAPAAAABQAgMAAABaJxDvAAAADFBMVEX///8FBQViYmK2trbObE4QAAAACXBIWXMAAAsTAAALEwEAmpwYAAABpUlEQVRYhe3VsW2EQBAF0A+IAEvrjBIogcCWgyvhAgaQ74KNHVECTeAOnGAH14FJXAJNuAM7wZqdRQ5h7PB2pBPcisfNzu3OAiFChAgR4hrj8/J3m1E98TWiHikR0Rm4Hc489EWHDVwQdXw1vzh2b8AdbeJBnkS64iOMDBWbOKZLWUkGPW7GcRzsfhzVMDXfzEPvBvIDzOnD4bdhA2cVYuKbxuO5R4KU8QO2cNoCNAFx6zF/EYxtfAaYmbPgxKWxE5dHeSa1guNagQsLzAegOAiOGiXOO2CeBJtKgfNOPs9u5lJAHbZIGo+5Bgpc9rlF1HrM01Dg2eYW2dFjzkSBh2NhUXYec+W1OO899mVTpT1MwhK3Ovfj+ym3Se1/UzaJ7q+KKo9lge3Gll9gTssyvE/rAtMtT8P9h/tG5haYbmOYFXul2pJmxYVbnbpmkCzLQjxnLoECt77zSLXnToOztQEK9o1sJ47W1itOktiLk7XpOyxJxOPL49jjfqSn133HDRhHLolYSl8SkSS1edBJA2502KwPMM4qHcb3Pw73ECFChLiy+AE9i7NYW8vcXAAAAABJRU5ErkJggg==",
"decimals": 0,
"meter_type": "water",
"previous_reading": 4650
}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
- Bildwerk0.01 USDC
address plate blur
POSThttps://bild.halowerk.com/v1/address-plate-blurThe photo is read with Tesseract 5.3.4 (German + English, word boxes) at two scales and in sparse-text and block mode; small bright plaques with 1–5 dark characters (typical house-number signs) are additionally cut out and read one by one,
- Bildwerk0.003 USDC
ai disclosure metadata
POSThttps://bild.halowerk.com/v1/ai-disclosure-metadataChecks JPEG, PNG and WebP files for AI disclosure metadata: XMP DigitalSourceType and the IPTC Photo Metadata 2025.1 AI fields, C2PA/JUMBF stores (signatures are not validated), PNG text chunks and EXIF Software/UserComment, and returns a s
- Bildwerk0.008 USDC
animation to video
POSThttps://bild.halowerk.com/v1/animation-to-videoReads 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