Skip to content
HALOWERK

Bildwerk

colony count

Grey copy (long side ≤ 1600), optional circular ROI, Otsu threshold inside it; objects are the minority class unless polarity is set. 8-connected components within min/max area (original pixels); objects on the image or ROI edge are skipped by default. Circularity 4π·A/P² (edge perimeter × π/4). Single size = median area of round objects (≥ 0.75); irregular clumps count as round(area / single size) in estimated_count.

POST https://bild.halowerk.com/v1/colony-count

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoImage (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB.
image_urlstringNoOr a public image URL.
polaritystringNoObjects darker or lighter.
min_area_pxintegerNoMin area (px).
max_area_pxintegerNoMax area (px, default 5 % of image).
roi_circleobjectNoCircular region (the plate), px.
thresholdintegerNoFixed threshold.
include_edgebooleanNoCount edge objects too.
max_objects_listedintegerNoObjects listed.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Image (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Or a public image URL."
    },
    "polarity": {
      "type": "string",
      "enum": [
        "auto",
        "dark_on_light",
        "light_on_dark"
      ],
      "default": "auto",
      "description": "Objects darker or lighter."
    },
    "min_area_px": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000,
      "default": 12,
      "description": "Min area (px)."
    },
    "max_area_px": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000000,
      "description": "Max area (px, default 5 % of image)."
    },
    "roi_circle": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "cx",
        "cy",
        "r"
      ],
      "description": "Circular region (the plate), px.",
      "properties": {
        "cx": {
          "type": "number"
        },
        "cy": {
          "type": "number"
        },
        "r": {
          "type": "number",
          "exclusiveMinimum": 0
        }
      }
    },
    "threshold": {
      "type": "integer",
      "minimum": 1,
      "maximum": 254,
      "description": "Fixed threshold."
    },
    "include_edge": {
      "type": "boolean",
      "default": false,
      "description": "Count edge objects too."
    },
    "max_objects_listed": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2000,
      "default": 200,
      "description": "Objects listed."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAKAAAAB4AgMAAAAIzBH8AAAADFBMVEU7LBHy6tDLwqh2aE4Zcn5WAAAACXBIWXMAAAsTAAALEwEAmpwYAAABoElEQVRYhe2XsW3DMBBFf+wqRdJlhIyQIp1HcBFSAqRCA7jwCFrCe2gELZERskcgWCTvyLsLUybgrwzw2fL/92Ge4SqFBlqCeUrUwF/HszzXgQPwVQVOwGMVOAOHKnAFjio4pK/lAeCmgQui024DPxXQkw/52MAXBewBvNaAI4C3GnBCyo6DQ3B5B68AnkQzS3B5B08AHqR4fHxdgizwProUQDrCMboUQFqKKboszbCaXeNBGQ8r7ik+qgyc6ZSBdIQm6MVmuRKkNWO6ZmZocZmmLB5VYxa4qj4boSqflULXwmuma+DFrRAaaAnmKVEDTcE+TmrgH4vHr+914AXHWxU4F7cE5CezC8oAO3rl5SDdyLaf7oMCso1suwyOCsg2svO2BTgZZBuZBa70YQbo2UZGQL/PCOISQ8xc9hlBXItIPPM+IxlMgfswIxlMI+zCW2QwlaIPX0I2k2o2BltyPKm45xCUHHjSuQDlpdqVoLymuxKUF39XmFH+SrgiHk1dHrgmn49Q1ZyVQtUlq5n+7JUX90ehgZZgnhI10NS/iucb/2rZfArPWCEAAAAASUVORK5CYII="
}

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 →