Skip to content
HALOWERK

Bildwerk

color cast

Converts opaque pixels of a copy with at most 512 px on the long side to CIELAB (D65, IEC 61966-2-1). Near-neutral reference: mean shift in the a*b* plane starting at (0, 0) with neutral_radius (default 12; the first step uses radius 25 only when fewer than 1 % of the pixels lie within it), centre kept within C* 25, over pixels with L* 20–95; at least 1 % of the pixels must belong to it. Its mean chroma C*ab is the cast (none < tolerance, default 3; slight < 5; moderate < 10; strong above),.

POST https://bild.halowerk.com/v1/color-cast

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.
tolerancenumberNoChroma C*ab of the neutral reference from which a cast is reported.
neutral_radiusnumberNoRadius in the a*b* plane around the neutral mean that still counts as neutral.
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."
    },
    "tolerance": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 20,
      "default": 3,
      "description": "Chroma C*ab of the neutral reference from which a cast is reported."
    },
    "neutral_radius": {
      "type": "number",
      "minimum": 4,
      "maximum": 20,
      "default": 12,
      "description": "Radius in the a*b* plane around the neutral mean that still counts as neutral."
    }
  }
}

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=="
}

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 →