Zum Inhalt
HALOWERK

Medienwerk

vocabulary

Takes a recording of up to 60 minutes in the language being learned and a learner level, and returns words and phrases worth learning — chosen for the level, skipping the most basic ones — each with the base form, translation into the learner's language, word type, an estimated CEFR level, and the exact example sentence from the recording with its timestamp so it can be listened to in context. Every finding carries a verbatim quote from the transcript; quotes are searched in the transcript.

POST https://medien.halowerk.com/v1/vocabulary

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
sourceobjectJaThe recording. Either url or content_base64.
duration_minutesintegerJaLength in started minutes — this is what you are billed for.
languagestringNeinSpoken language (BCP-47). Omit to detect.
output_languagestringNeinLanguage of labels and explanations. Default: spoken language.
levelstringNein
max_itemsintegerNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "source",
    "duration_minutes"
  ],
  "additionalProperties": false,
  "properties": {
    "source": {
      "type": "object",
      "additionalProperties": false,
      "description": "The recording. Either url or content_base64.",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048,
          "description": "Public http(s) URL of the file."
        },
        "content_base64": {
          "type": "string",
          "maxLength": 12000000,
          "description": "The file inline, base64. Larger files by url."
        },
        "filename": {
          "type": "string",
          "maxLength": 260
        }
      }
    },
    "duration_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "Length in started minutes — this is what you are billed for."
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "Spoken language (BCP-47). Omit to detect."
    },
    "output_language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es",
        "fr",
        "it",
        "nl",
        "pt",
        "pl",
        "tr",
        "sv",
        "da",
        "cs",
        "ru",
        "uk",
        "ja",
        "zh",
        "ko",
        "ar"
      ],
      "description": "Language of labels and explanations. Default: spoken language."
    },
    "level": {
      "type": "string",
      "enum": [
        "A1",
        "A2",
        "B1",
        "B2",
        "C1",
        "C2"
      ],
      "default": "B1"
    },
    "max_items": {
      "type": "integer",
      "minimum": 5,
      "maximum": 80,
      "default": 25
    }
  }
}

Originalschema öffnen

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →