Zum Inhalt
HALOWERK

Medienwerk

stt

Takes an audio or video file by URL or inline base64 and returns the transcript: the full text, every word with start and end time and its own confidence, the utterances and paragraphs the recogniser separated, and the detected language with its confidence where no language was specified.

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

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
sourceobjectJaThe recording. Either url or content_base64.
duration_minutesintegerJaLength of the recording in started minutes — this is what you are billed for. A longer file is refused with its real length and nothing is charged; a shorter one costs what you declared, and the answer says how much less it would have been.
languagestringNeinBCP-47 code such as de, en, es. "multi" enables multilingual recognition and is billed at the provider's higher rate. Omit to let the recogniser detect the language.
confidence_thresholdnumberNeinWords below this confidence are listed separately as the passages worth checking.
include_wordsbooleanNeinReturn every word with its timestamp. Off returns only the text, paragraphs and utterances.
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 audio or video file."
        },
        "content_base64": {
          "type": "string",
          "maxLength": 12000000,
          "description": "The file inline, base64. Larger files must come by url."
        },
        "filename": {
          "type": "string",
          "maxLength": 260
        }
      }
    },
    "duration_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Length of the recording in started minutes — this is what you are billed for. A longer file is refused with its real length and nothing is charged; a shorter one costs what you declared, and the answer says how much less it would have been."
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "BCP-47 code such as de, en, es. \"multi\" enables multilingual recognition and is billed at the provider's higher rate. Omit to let the recogniser detect the language."
    },
    "confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.7,
      "description": "Words below this confidence are listed separately as the passages worth checking."
    },
    "include_words": {
      "type": "boolean",
      "default": true,
      "description": "Return every word with its timestamp. Off returns only the text, paragraphs and utterances."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "source": {
    "url": "https://example.com/besprechung.mp3"
  },
  "duration_minutes": 3,
  "language": "de",
  "confidence_threshold": 0.7
}

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 →