Skip to content
HALOWERK

Bildwerk

image keywords de

Two open models run locally: OpenAI CLIP ViT-B/32 (MIT, fp16 ONNX, SHA-256 pinned) scores the image against a curated German vocabulary of 236 concepts (people, animals, vehicles, landscapes, rooms, objects, activities, photo types; each with an English prompt ensemble; daten/C07/vokabular.json, 2026-11-13) and RT-DETRv2-S (Apache-2.0, COCO 2017) adds detected objects (score >= 0.6) with German names. CLIP scores are a softmax over the vocabulary (temperature 100); keywords above.

POST https://bild.halowerk.com/v1/image-keywords-de

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.
max_keywordsintegerNoMaximum number of keywords returned (after adding objects and broader terms).
min_confidencenumberNoMinimum CLIP softmax share for a vocabulary concept (the best concept is always kept).
include_objectsbooleanNoAdd objects found by the detector (80 COCO classes, German names).
include_broaderbooleanNoAdd broader terms of the chosen keywords (e.g. Fahrzeug, Tier, Landschaft).
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."
    },
    "max_keywords": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 15,
      "description": "Maximum number of keywords returned (after adding objects and broader terms)."
    },
    "min_confidence": {
      "type": "number",
      "minimum": 0.005,
      "maximum": 0.9,
      "default": 0.03,
      "description": "Minimum CLIP softmax share for a vocabulary concept (the best concept is always kept)."
    },
    "include_objects": {
      "type": "boolean",
      "default": true,
      "description": "Add objects found by the detector (80 COCO classes, German names)."
    },
    "include_broader": {
      "type": "boolean",
      "default": true,
      "description": "Add broader terms of the chosen keywords (e.g. Fahrzeug, Tier, Landschaft)."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAEAAAAAwBAMAAABTZWEsAAAAJ1BMVEV6uOjo16j/003jzW9+ueX50lTmzmuIu9eyw6fmzmqzxKWzw6b40VZx3hZPAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAV0lEQVQ4y2NgGLzAyzR4Cz559klKSmoFeBR4KgFBCh4Fi0AKNPAoMAIpUMajIAikQJWQAh1KrNhEyJFuhLzJnkQgoBg8TINbGEbBsAOCBMCoglEFJCkAAMKYNKuC2Gj3AAAAAElFTkSuQmCC",
  "max_keywords": 8
}

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 →