Skip to content
HALOWERK

Bildwerk

horizon level

Finds strong edges (Sobel magnitude above the 90th percentile and at least 16) whose orientation lies within max_angle of horizontal on a copy with at most 800 px on the long side, votes them into an orientation-constrained Hough accumulator (0.1° steps), takes the strongest line and refines it with a weighted total-least-squares fit of the supporting edge pixels. A horizon is accepted when the supporting pixels span at least a quarter of the width. tilt_deg is counter-clockwise positive.

POST https://bild.halowerk.com/v1/horizon-level

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoThe image (PNG, JPEG, WebP, GIF, TIFF or AVIF) as base64 or data: URL, at most 10 MB decoded. Give either image_base64 or image_url.
image_urlstringNoPublic http(s) URL of the image, fetched once (at most 10 MB). Private and local addresses are refused.
max_anglenumberNoLargest tilt in degrees that is searched.
tolerance_degnumberNoTilt up to this many degrees counts as level.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The image (PNG, JPEG, WebP, GIF, TIFF or AVIF) as base64 or data: URL, at most 10 MB decoded. Give either image_base64 or image_url."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the image, fetched once (at most 10 MB). Private and local addresses are refused."
    },
    "max_angle": {
      "type": "number",
      "minimum": 1,
      "maximum": 30,
      "default": 15,
      "description": "Largest tilt in degrees that is searched."
    },
    "tolerance_deg": {
      "type": "number",
      "minimum": 0.05,
      "maximum": 5,
      "default": 0.5,
      "description": "Tilt up to this many degrees counts as level."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAQAAAADABAMAAAAZw6BVAAAAMFBMVEWcx+gtX4ry8vL0xUJ6enro6elAQEDC2evd6PBKe6NqmL6Hs9bexmy3x7XLxpCox9Eu6nMPAAAACXBIWXMAAAsTAAALEwEAmpwYAAAC7ElEQVR4nO2YsYobMRCGB1LY4FwOvYLAnMuA2rtU9wDhQChPoFqkscuwcHjblH6E7CNkm0DaKwLpQyB14B4hXI449tq3mpWlneL+r/f+nzWz2pGIAAAAAAAAAHwmy/pW63f1MpAEk0pvWSzHz6/0HheCf/+RxRh1mCxXdX2j9fxWHzJnGvy4M+bud0L6cqX7WXCecvbV/OXy29D4KhKvtX7Lzx9qMGHEa62jzznf5htzec/PX7HiGUvw/X++MVfs/IqZH30XX+3mG/Mzd76OteGvfYE3vPz37PxYE3QWgLkEU51NYK8D2F1QDcjvL8F5N9+Y+8wLcNH7qJeHAl/ydoD+MKwCrBpUQwT6H7WzCW03o7iAHkD/PnR2mG9MfD/WOtcucKQFOE1QsfNjn+MXxwRe52vCRWwcONKDnC6cMvPjI1lnH2bvxhUrnzGUHnkJWK/B9PQN4DQBYnQBayQ+lm8M55eVzjEMniBAEQPmkeAEAeodydZUXoCeHkr555HkJuwby4ecCU8UIJqsbvbT5+tBp7HUjWiPf0ezul4PPpMnbsX5SPwY5SPxc5yPxIEkI2kjWUbShtKMpI3lGUk7mOQk7Wg2AO9LHE4zCiQez/l4H4pcULDx3pW5ouHivQ1lLqmYeG9doWs6Ht7b2BKkX1RyBVy5q1qeQHQJSuIfBJy0gA3SAk5awAZpASctYIO0gJMWsEFawEkL2CAt4KQFbJAWcNICNkgLOGkBG6QFnLSADdICTlrABmkBJyBAsngI+PFX/boXCBBKUJ5rNGEvzGWctW3bNE2z2Ww2apwStG37uWmaTw+JHaiQwE7kx25mOYHmcV37E0sKqARoCLN2dIG2U8oRBNqdV+SQEgKz/sjiAkoYgoBCCYQhCCiUQBiCgEIJhCEIKJRAGIKAQgmEIQgolEAYgoBCCYQhCCiUQBiCgEIJhCEIKJRAGIKAQgmEIQgolEAYgoBCCYQhCCiUQBiCgEIJhCEIqOdegj/PHD32FXYvaAAAAABJRU5ErkJggg==",
  "max_angle": 10
}

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 →