Zum Inhalt
HALOWERK

Medienwerk

reading check

Takes a recording and the text that was supposed to be read, and returns a reading assessment. The recording is transcribed with word timestamps and aligned to the text by global sequence alignment, ignoring case and punctuation. Every text word is marked correct, substituted (with what was heard), or omitted; words spoken but not in the text are listed as insertions. From this come accuracy, words correct per minute (WCPM, the standard reading-fluency measure), reading time, and hesitations.

POST https://medien.halowerk.com/v1/reading-check

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.
textstringJaThe text that was to be read.
languagestringNeinLanguage of the text (BCP-47). Strongly recommended.
pause_secondsnumberNein
confidence_thresholdnumberNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "source",
    "duration_minutes",
    "text"
  ],
  "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": 15,
      "description": "Length in started minutes — this is what you are billed for."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30000,
      "description": "The text that was to be read."
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "Language of the text (BCP-47). Strongly recommended."
    },
    "pause_seconds": {
      "type": "number",
      "minimum": 0.3,
      "maximum": 5,
      "default": 1
    },
    "confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.6
    }
  }
}

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 →