Bildwerk
print readiness
Reads the image header (dimensions after EXIF orientation, colour space, ICC profile description, bit depth, stored density, alpha and actual transparency) and relates it to the print size plus bleed on each side. Paper sizes: ISO 216 A0–A7, B4, B5; ANSI letter, legal, tabloid; ISO/IEC 7810 ID-1 card; photo 4×6, 5×7, 8×10, 11×14 inch; or width_mm/height_mm. The paper is turned to match the image orientation. fit=fit places the whole image (effective ppi = lower axis, unprinted margin.
POST https://bild.halowerk.com/v1/print-readinessInputs
| 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. |
| paper | string | No | Named print size; or give width_mm and height_mm. |
| width_mm | number | No | Custom print width in millimetres (with height_mm). |
| height_mm | number | No | Custom print height in millimetres (with width_mm). |
| bleed_mm | number | No | Bleed added on every side (often 3 mm). |
| fit | string | No | fit: whole image on the paper (margins possible); fill: paper fully covered (image cropped). |
| target_ppi | integer | No | Resolution for a "good" rating. |
| min_ppi | integer | No | Lowest acceptable resolution. |
| require_cmyk | boolean | No | Fail when the file is not CMYK (some print shops require it). |
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."
},
"paper": {
"type": "string",
"enum": [
"A0",
"A1",
"A2",
"A3",
"A4",
"A5",
"A6",
"A7",
"B4",
"B5",
"letter",
"legal",
"tabloid",
"id1_card",
"photo_4x6in",
"photo_5x7in",
"photo_8x10in",
"photo_11x14in"
],
"description": "Named print size; or give width_mm and height_mm."
},
"width_mm": {
"type": "number",
"minimum": 10,
"maximum": 5000,
"description": "Custom print width in millimetres (with height_mm)."
},
"height_mm": {
"type": "number",
"minimum": 10,
"maximum": 5000,
"description": "Custom print height in millimetres (with width_mm)."
},
"bleed_mm": {
"type": "number",
"minimum": 0,
"maximum": 20,
"default": 0,
"description": "Bleed added on every side (often 3 mm)."
},
"fit": {
"type": "string",
"enum": [
"fit",
"fill"
],
"default": "fit",
"description": "fit: whole image on the paper (margins possible); fill: paper fully covered (image cropped)."
},
"target_ppi": {
"type": "integer",
"minimum": 72,
"maximum": 1200,
"default": 300,
"description": "Resolution for a \"good\" rating."
},
"min_ppi": {
"type": "integer",
"minimum": 50,
"maximum": 600,
"default": 150,
"description": "Lowest acceptable resolution."
},
"require_cmyk": {
"type": "boolean",
"default": false,
"description": "Fail when the file is not CMYK (some print shops require it)."
}
}
}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==",
"paper": "id1_card",
"fit": "fill",
"bleed_mm": 2
}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