Bildwerk
logo find
Template matching with zero-mean normalised cross-correlation (ZNCC) on grey levels, run in a sandboxed worker. The logo is trimmed to its opaque area; transparent pixels are excluded via a mask. The scene (max. 1024 px long side) is searched over an image pyramid (factor sqrt 2) at logo widths from min_size_fraction to max_size_fraction of the image width in steps of 20 %, on the coarsest level where the template still has 200 pixels; the best candidates are refined on a finer level.
POST https://bild.halowerk.com/v1/logo-findInputs
| Field | Type | Required | Description |
|---|---|---|---|
| image_base64 | string | No | The image to search (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 to search, fetched once (at most 10 MB). Private and local addresses are refused. |
| logos | array | Yes | One to three logos to look for. |
| min_score | number | No | Minimum ZNCC score of a match (1 = identical up to brightness and contrast). |
| min_size_fraction | number | No | Smallest logo width searched, as a fraction of the image width (at least 20 px after scaling to 1024 px). |
| max_size_fraction | number | No | Largest logo width searched, as a fraction of the image width. |
| max_matches | integer | No | Maximum matches per logo. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"logos"
],
"properties": {
"image_base64": {
"type": "string",
"minLength": 16,
"maxLength": 14000000,
"description": "The image to search (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 to search, fetched once (at most 10 MB). Private and local addresses are refused."
},
"logos": {
"type": "array",
"minItems": 1,
"maxItems": 3,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 80,
"description": "Optional label of the logo."
},
"image_base64": {
"type": "string",
"minLength": 16,
"maxLength": 2800000,
"description": "The logo (PNG with transparency preferred) as base64, at most 2 MB."
},
"image_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public URL of the logo (at most 2 MB)."
}
}
},
"description": "One to three logos to look for."
},
"min_score": {
"type": "number",
"minimum": 0.5,
"maximum": 0.99,
"default": 0.8,
"description": "Minimum ZNCC score of a match (1 = identical up to brightness and contrast)."
},
"min_size_fraction": {
"type": "number",
"minimum": 0.01,
"maximum": 0.9,
"default": 0.03,
"description": "Smallest logo width searched, as a fraction of the image width (at least 20 px after scaling to 1024 px)."
},
"max_size_fraction": {
"type": "number",
"minimum": 0.05,
"maximum": 1,
"default": 1,
"description": "Largest logo width searched, as a fraction of the image width."
},
"max_matches": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5,
"description": "Maximum matches per logo."
}
}
}Published input example
{
"image_base64": "iVBORw0KGgoAAAANSUhEUgAAAKAAAABkBAMAAADzmCa8AAAAD1BMVEXZ1MceNVf////zoWGufl6NnuztAAAACXBIWXMAAAPoAAAD6AG1e1JrAAAAWklEQVRYw+3UwQmAMAxA0axQdAI3kHYB6f47aS+evBlB9L0BPoSERAAAAAAAEeXC94O95QZ7rS01WA+lLKe7wXkEt8TgNILrm4PpI6cvJf9s0g/7d88BAHjSDskEHvMz+Z4/AAAAAElFTkSuQmCC",
"logos": [
{
"name": "Warehouse emblem",
"image_base64": "iVBORw0KGgoAAAANSUhEUgAAACgAAAAQAgMAAAAZudU+AAAADFBMVEXzoWEeNVf///+ufl5ZXSAnAAAACXBIWXMAAAsTAAALEwEAmpwYAAAANElEQVQI12MIhQMGHMwYUzjzADOcycAQugoEQhnCGRiuQpkhDAyimEwkBUjakA1DsoKAcwBmRDudaXl77wAAAABJRU5ErkJggg=="
}
],
"min_size_fraction": 0.2,
"max_size_fraction": 0.4
}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