Skip to content
HALOWERK

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoThe 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_urlstringNoPublic http(s) URL of the image to search, fetched once (at most 10 MB). Private and local addresses are refused.
logosarrayYesOne to three logos to look for.
min_scorenumberNoMinimum ZNCC score of a match (1 = identical up to brightness and contrast).
min_size_fractionnumberNoSmallest logo width searched, as a fraction of the image width (at least 20 px after scaling to 1024 px).
max_size_fractionnumberNoLargest logo width searched, as a fraction of the image width.
max_matchesintegerNoMaximum 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."
    }
  }
}

Open original schema

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

All endpoints in this hub →