Skip to content
HALOWERK

Textwerk

exercise gen

Builds cloze exercises from your own text without any language model: articles and adjective endings come from determiner–adjective–noun phrases checked against german-pos-dict 1.2.4 (CC BY-SA 4.0), prepositions from its preposition list with governed case as hint, finite verbs from its verb forms with the infinitive as hint. The C-test follows Klein-Braley and Raatz (1984): from the second sentence on, the second half of every second word is deleted (the larger half for odd lengths), first.

POST https://text.halowerk.com/v1/exercise-gen

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman source text.
typestringYesExercise type.
max_gapsintegerNoMaximum number of gaps.
keep_first_sentencebooleanNoLeave the first sentence without gaps (always true for c_test).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text",
    "type"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 20,
      "maxLength": 20000,
      "description": "German source text."
    },
    "type": {
      "type": "string",
      "enum": [
        "articles",
        "prepositions",
        "verbs",
        "adjective_endings",
        "c_test"
      ],
      "description": "Exercise type."
    },
    "max_gaps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Maximum number of gaps."
    },
    "keep_first_sentence": {
      "type": "boolean",
      "default": true,
      "description": "Leave the first sentence without gaps (always true for c_test)."
    }
  }
}

Open original schema

Published input example

{
  "text": "Heute ist ein schöner Tag. Der Hund spielt mit dem Ball im Garten. Die Katze schläft auf einem Stuhl.",
  "type": "articles"
}

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 →