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-cropInputs
| Field | Type | Required | Description |
|---|---|---|---|
| image_base64 | string | No | 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 | string | No | Public http(s) URL of the image, fetched once (at most 10 MB). Private and local addresses are refused. |
| ratios | array | No | Aspect ratios as width:height, e.g. "1:1", "4:5", "16:9", "9:16". |
| protect | array | No | Regions in original pixels that must stay fully inside every crop. |
| return_images | boolean | No | Also return each crop as a JPEG (base64). |
| max_output_side | integer | No | Long 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."
}
}
}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
- 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