Skip to content
HALOWERK

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-readiness

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.
paperstringNoNamed print size; or give width_mm and height_mm.
width_mmnumberNoCustom print width in millimetres (with height_mm).
height_mmnumberNoCustom print height in millimetres (with width_mm).
bleed_mmnumberNoBleed added on every side (often 3 mm).
fitstringNofit: whole image on the paper (margins possible); fill: paper fully covered (image cropped).
target_ppiintegerNoResolution for a "good" rating.
min_ppiintegerNoLowest acceptable resolution.
require_cmykbooleanNoFail 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)."
    }
  }
}

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

All endpoints in this hub →