Bildwerk
gauge read
Samples the grey image along rays from the centre (default image centre, radius 45 % of the shorter side) every 0.25° between 20 % and 70 % of the radius, avoiding hub and ticks. Needle = direction of strongest dark (or light) contrast to the dial median, smoothed ±1° with parabolic refinement. Angles clockwise from 12 o'clock. The value is interpolated between your scale points in the given direction; outside the span the nearer end is reported.
POST https://bild.halowerk.com/v1/gauge-readInputs
| 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. |
| center | object | No | Needle pivot (default image centre). |
| radius | number | No | Dial radius (default 45 % of short side). |
| min_angle_deg | number | No | Scale start, ° clockwise from 12 o'clock. |
| max_angle_deg | number | No | Scale end angle. |
| min_value | number | No | Value at start. |
| max_value | number | No | Value at end. |
| scale_points | array | No | Instead of min/max: points in scale order. |
| direction | string | No | Values increase this way. |
| needle | string | No | Needle vs dial. |
| unit | string | No | Echoed unit. |
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."
},
"center": {
"type": "object",
"additionalProperties": false,
"required": [
"x",
"y"
],
"description": "Needle pivot (default image centre).",
"properties": {
"x": {
"type": "number",
"minimum": 0
},
"y": {
"type": "number",
"minimum": 0
}
}
},
"radius": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000,
"description": "Dial radius (default 45 % of short side)."
},
"min_angle_deg": {
"type": "number",
"minimum": -360,
"maximum": 360,
"description": "Scale start, ° clockwise from 12 o'clock."
},
"max_angle_deg": {
"type": "number",
"minimum": -360,
"maximum": 360,
"description": "Scale end angle."
},
"min_value": {
"type": "number",
"description": "Value at start."
},
"max_value": {
"type": "number",
"description": "Value at end."
},
"scale_points": {
"type": "array",
"minItems": 2,
"maxItems": 30,
"description": "Instead of min/max: points in scale order.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"angle_deg",
"value"
],
"properties": {
"angle_deg": {
"type": "number"
},
"value": {
"type": "number"
}
}
}
},
"direction": {
"type": "string",
"enum": [
"clockwise",
"counterclockwise"
],
"default": "clockwise",
"description": "Values increase this way."
},
"needle": {
"type": "string",
"enum": [
"dark",
"light"
],
"default": "dark",
"description": "Needle vs dial."
},
"unit": {
"type": "string",
"maxLength": 16,
"description": "Echoed unit."
}
}
}Published input example
{
"image_base64": "iVBORw0KGgoAAAANSUhEUgAAAHgAAAB4AQMAAAADqqSRAAAABlBMVEX+/v4dHR2T1n7oAAAACXBIWXMAAAsTAAALEwEAmpwYAAACMElEQVQ4jaWVMY7VMBCG/2BpTbF6oUwRkitsmSIQToL2CCkjhN5a4hIchYLCVFwjEgcgHSmeMJqxPZ6Xp5VATOH4ixLP75mxB/grq8OmsQohOMV9CGFXHC7oQ0Eb0CCs5fMNDeryw5NDg+q3rH4BGmDKHszGXPssxjObLKn/zNzkBc8tP4Zz4v2eHw99Wn478XOuowOz3vHz0UYH1iWuouL0Gy3E41vhjzyOwiOPi3DHY4lcze5LHCwJMHlbcDzll/yh50+Fzcpcy9+el+5KWAy5biUsrh5IFA1kEzoSuMTo0D4GErjcy24eOi13j76y3GoHrJJP4bcOVXZvV8C4sh2KpvH0KslztKXCFNbKl+1RWKuVXETj7Cm+RK6VHGBDzCVlFZRTYcM6C8fkziknUQ6wIEejZx6EJx4Lx2Ia8HpXue+/4M1F1cb0FeNLJefViEHLQZt5OnDwB3ZXXP0nI53G9jkeD5ysVdVNNt5we8XDP3N3xYvkK9qMk34xzzjlU012nvU1ArpY7DvFL1T9sK2l3siqtdQjs79lr9j4Uu/MTh9n8OJXDH38wcVbrgfw5o88Kh45BcUGuVSiLfo+QPRl3WOiu3R/ZEWW2XzLOzCfaFb9kAvnO89+yXI/efwg/F5EFXm4uQ974V2CEtdfo1vR4+PrHKF0H6ffykI54/kZj2r5LjUG6QdpIv2C+gkdOcnsE81Kv6GygS4kS6dD9SuEHZPqZzf97tgPj/3yefsDLgi1JHerYHIAAAAASUVORK5CYII=",
"min_angle_deg": -135,
"max_angle_deg": 135,
"min_value": 0,
"max_value": 10,
"unit": "bar"
}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