Skip to content
HALOWERK

Bildwerk

object count

RT-DETRv2-S (Apache-2.0, COCO 2017, pinned ONNX) runs on the whole image and, for images with a long side of 900 px or more, on 6 overlapping tiles (3x2 or 2x3, 20 % overlap) so small persons and vehicles are not lost at 640x640. Tile boxes cut by an inner tile edge or larger than 45 % of the tile are dropped (the whole-image pass covers large objects); the remaining boxes of each target are merged greedily (IoU > 0.5 or 80 % of the smaller box covered). Targets: single COCO classes or the.

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

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.
targetsarrayNoWhat to count: COCO class names or the groups vehicle, motor_vehicle, animal. Pallets and other non-COCO objects are not available.
min_scorenumberNoMinimum detection score (0.4 balances missed people in crowds against false detections).
regionarrayNoOptional counting area as polygon [[x,y],...] in normalised image coordinates (0..1, origin top left).
anchorstringNoPoint of each box that must lie inside the region (bottom_center = where a person or car touches the ground).
tilingstringNoauto = whole image plus 6 tiles for images >= 900 px; off = one pass.
include_boxesbooleanNoAlso return the counted boxes (pixels).
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."
    },
    "targets": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "vehicle",
          "motor_vehicle",
          "animal",
          "person",
          "bicycle",
          "car",
          "motorcycle",
          "airplane",
          "bus",
          "train",
          "truck",
          "boat",
          "traffic light",
          "fire hydrant",
          "stop sign",
          "parking meter",
          "bench",
          "bird",
          "cat",
          "dog",
          "horse",
          "sheep",
          "cow",
          "elephant",
          "bear",
          "zebra",
          "giraffe",
          "backpack",
          "umbrella",
          "handbag",
          "tie",
          "suitcase",
          "frisbee",
          "skis",
          "snowboard",
          "sports ball",
          "kite",
          "baseball bat",
          "baseball glove",
          "skateboard",
          "surfboard",
          "tennis racket",
          "bottle",
          "wine glass",
          "cup",
          "fork",
          "knife",
          "spoon",
          "bowl",
          "banana",
          "apple",
          "sandwich",
          "orange",
          "broccoli",
          "carrot",
          "hot dog",
          "pizza",
          "donut",
          "cake",
          "chair",
          "couch",
          "potted plant",
          "bed",
          "dining table",
          "toilet",
          "tv",
          "laptop",
          "mouse",
          "remote",
          "keyboard",
          "cell phone",
          "microwave",
          "oven",
          "toaster",
          "sink",
          "refrigerator",
          "book",
          "clock",
          "vase",
          "scissors",
          "teddy bear",
          "hair drier",
          "toothbrush"
        ]
      },
      "uniqueItems": true,
      "minItems": 1,
      "maxItems": 10,
      "default": [
        "person",
        "vehicle"
      ],
      "description": "What to count: COCO class names or the groups vehicle, motor_vehicle, animal. Pallets and other non-COCO objects are not available."
    },
    "min_score": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 0.95,
      "default": 0.4,
      "description": "Minimum detection score (0.4 balances missed people in crowds against false detections)."
    },
    "region": {
      "type": "array",
      "minItems": 3,
      "maxItems": 32,
      "items": {
        "type": "array",
        "minItems": 2,
        "maxItems": 2,
        "items": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        }
      },
      "description": "Optional counting area as polygon [[x,y],...] in normalised image coordinates (0..1, origin top left)."
    },
    "anchor": {
      "type": "string",
      "enum": [
        "bottom_center",
        "center"
      ],
      "default": "bottom_center",
      "description": "Point of each box that must lie inside the region (bottom_center = where a person or car touches the ground)."
    },
    "tiling": {
      "type": "string",
      "enum": [
        "auto",
        "off"
      ],
      "default": "auto",
      "description": "auto = whole image plus 6 tiles for images >= 900 px; off = one pass."
    },
    "include_boxes": {
      "type": "boolean",
      "default": false,
      "description": "Also return the counted boxes (pixels)."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAEAAAAAwBAMAAABTZWEsAAAAJ1BMVEV6uOjo16j/003jzW9+ueX50lTmzmuIu9eyw6fmzmqzxKWzw6b40VZx3hZPAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAV0lEQVQ4y2NgGLzAyzR4Cz559klKSmoFeBR4KgFBCh4Fi0AKNPAoMAIpUMajIAikQJWQAh1KrNhEyJFuhLzJnkQgoBg8TINbGEbBsAOCBMCoglEFJCkAAMKYNKuC2Gj3AAAAAElFTkSuQmCC",
  "targets": [
    "person",
    "vehicle"
  ],
  "tiling": "off"
}

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 →