Skip to content
HALOWERK

Bildwerk

smart crop

Computes frequency-tuned saliency (Achanta et al., CVPR 2009): distance in CIELAB (D65) between each pixel of a 5×5 binomially smoothed copy and the image mean colour, on a copy with at most 400 px on the long side. For each ratio the largest crop of that ratio (full height or full width) is slid along the free axis; the position keeping the most saliency wins, ties go to the position nearest the saliency centroid. Protected regions (subject boxes you know, e.g. faces or products) must lie.

POST https://bild.halowerk.com/v1/smart-crop

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.
ratiosarrayNoAspect ratios as width:height, e.g. "1:1", "4:5", "16:9", "9:16".
protectarrayNoRegions in original pixels that must stay fully inside every crop.
return_imagesbooleanNoAlso return each crop as a JPEG (base64).
max_output_sideintegerNoLong side of returned crop images.
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."
    },
    "ratios": {
      "type": "array",
      "minItems": 1,
      "maxItems": 8,
      "default": [
        "1:1",
        "4:5",
        "16:9"
      ],
      "items": {
        "type": "string",
        "pattern": "^[1-9][0-9]?:[1-9][0-9]?$"
      },
      "description": "Aspect ratios as width:height, e.g. \"1:1\", \"4:5\", \"16:9\", \"9:16\"."
    },
    "protect": {
      "type": "array",
      "maxItems": 8,
      "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
          }
        }
      },
      "description": "Regions in original pixels that must stay fully inside every crop."
    },
    "return_images": {
      "type": "boolean",
      "default": false,
      "description": "Also return each crop as a JPEG (base64)."
    },
    "max_output_side": {
      "type": "integer",
      "minimum": 64,
      "maximum": 2048,
      "default": 1080,
      "description": "Long side of returned crop images."
    }
  }
}

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==",
  "ratios": [
    "1:1",
    "9:16"
  ]
}

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 →