Skip to content
HALOWERK

Bildwerk

scene classify

OpenAI CLIP ViT-B/32 (MIT, fp16 ONNX, SHA-256 pinned) embeds the centre-cropped image; the embedding is compared with prompt ensembles for 53 scene types (three English templates each, daten/C07/vokabular.json, 2026-11-13) and softmax-normalised (temperature 100). Indoor probability weights a direct indoor/outdoor prompt pair by 1/3 and the summed probability of all indoor scene types by 2/3 (the prompt pair alone misjudged open car parks in our tests); between 0.35 and 0.65 the environment.

POST https://bild.halowerk.com/v1/scene-classify

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.
top_kintegerNoNumber of scene types returned.
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."
    },
    "top_k": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "Number of scene types returned."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAEAAAAAwBAMAAABTZWEsAAAAJ1BMVEV6uOjo16j/003jzW9+ueX50lTmzmuIu9eyw6fmzmqzxKWzw6b40VZx3hZPAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAV0lEQVQ4y2NgGLzAyzR4Cz559klKSmoFeBR4KgFBCh4Fi0AKNPAoMAIpUMajIAikQJWQAh1KrNhEyJFuhLzJnkQgoBg8TINbGEbBsAOCBMCoglEFJCkAAMKYNKuC2Gj3AAAAAElFTkSuQmCC",
  "top_k": 3
}

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 →