Skip to content
HALOWERK

Bildwerk

object detect

Runs RT-DETRv2-S (r18vd backbone, PekingU, Apache-2.0, trained on COCO 2017) as a pinned ONNX file (SHA-256 checked) with onnxruntime-node on CPU. The image is EXIF-rotated, stretched to 640x640 and scaled to 0..1 as in the model's preprocessor_config.json; the 300 queries are decoded with a sigmoid per class (focal-loss head, no NMS needed) and boxes are mapped back to the original pixels. Optional class filter and score threshold. Boxes are returned in pixels and normalised 0..1..

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

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.
min_scorenumberNoMinimum detection score.
classesarrayNoOnly report these COCO classes (English names).
max_detectionsintegerNoMaximum number of boxes, highest scores first.
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."
    },
    "min_score": {
      "type": "number",
      "minimum": 0.2,
      "maximum": 0.95,
      "default": 0.5,
      "description": "Minimum detection score."
    },
    "classes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "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": 80,
      "description": "Only report these COCO classes (English names)."
    },
    "max_detections": {
      "type": "integer",
      "minimum": 1,
      "maximum": 300,
      "default": 100,
      "description": "Maximum number of boxes, highest scores first."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAEAAAAAwBAMAAABTZWEsAAAAJ1BMVEV6uOjo16j/003jzW9+ueX50lTmzmuIu9eyw6fmzmqzxKWzw6b40VZx3hZPAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAV0lEQVQ4y2NgGLzAyzR4Cz559klKSmoFeBR4KgFBCh4Fi0AKNPAoMAIpUMajIAikQJWQAh1KrNhEyJFuhLzJnkQgoBg8TINbGEbBsAOCBMCoglEFJCkAAMKYNKuC2Gj3AAAAAElFTkSuQmCC",
  "min_score": 0.6
}

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 →