Skip to content
HALOWERK

Denkwerk

hybrid search

Ranks up to 100 supplied documents twice: lexically with BM25 (same implementation and defaults as bm25-search) and semantically by cosine similarity of embeddings computed locally (multilingual: intfloat/multilingual-e5-small, MIT, with the required "query: "/"passage: " prefixes, truncation at 512 tokens; english: sentence-transformers/all-MiniLM-L6-v2, Apache-2.0, truncation at 256 word pieces; mean pooling and L2 normalization, int8 ONNX exports from the model repositories, pinned and.

POST https://denk.halowerk.com/v1/hybrid-search

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
querystringYes
documentsarrayYesStrings or objects {id, text}.
modelstringNo
fusionstringNo
rrf_kintegerNo
alphanumberNoweighted: share of the vector score.
top_kintegerNo
stemmingstringNo
max_lengthintegerNoToken limit per text for the embedding model (default and maximum: 512 multilingual, 256 english).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "query",
    "documents"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "documents": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "description": "Strings or objects {id, text}.",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1,
            "maxLength": 4000
          },
          {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "text"
            ],
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 128
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 4000
              },
              "score": {
                "type": "number"
              }
            }
          }
        ]
      }
    },
    "model": {
      "type": "string",
      "enum": [
        "multilingual",
        "english"
      ],
      "default": "multilingual"
    },
    "fusion": {
      "type": "string",
      "enum": [
        "rrf",
        "weighted"
      ],
      "default": "rrf"
    },
    "rrf_k": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 60
    },
    "alpha": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5,
      "description": "weighted: share of the vector score."
    },
    "top_k": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10
    },
    "stemming": {
      "type": "string",
      "enum": [
        "none",
        "german"
      ],
      "default": "none"
    },
    "max_length": {
      "type": "integer",
      "minimum": 32,
      "maximum": 512,
      "description": "Token limit per text for the embedding model (default and maximum: 512 multilingual, 256 english)."
    }
  }
}

Open original schema

Published input example

{
  "query": "Wie hoch ist die Mehrwertsteuer?",
  "documents": [
    "Der allgemeine Umsatzsteuersatz in Deutschland beträgt 19 Prozent.",
    "Die Hauptstadt ist Berlin."
  ]
}

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 →