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/sttEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| source | object | Ja | The recording. Either url or content_base64. |
| duration_minutes | integer | Ja | 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 | string | Nein | 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 | number | Nein | Words below this confidence are listed separately as the passages worth checking. |
| include_words | boolean | Nein | Return 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."
}
}
}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
- Medienwerk0,03 USDC · variabel
ad detect
POSThttps://medien.halowerk.com/v1/ad-detectTakes a podcast episode of up to 120 minutes and returns its advertising segments: paid sponsor reads, self-promotion (newsletter, Patreon, merchandise) and cross-promotion of other shows, each with start and end on sentence boundaries, the
- Medienwerk0,004 USDC · variabel
audio concat
POSThttps://medien.halowerk.com/v1/audio-concatTakes 2 to 10 audio or video files (each up to 24 MB, together up to 60 minutes) and joins their audio in the given order. Between parts either a pause of chosen length or a crossfade is placed; optionally every part is brought to a common
- Medienwerk0,002 USDC · variabel
audio convert
POSThttps://medien.halowerk.com/v1/audio-convertTakes an audio or video file and returns the audio in the requested format — MP3, Opus, Ogg Vorbis, AAC in M4A, WAV or FLAC — with selectable bitrate for lossy formats, sample rate and mono or stereo. Only the first audio stream is converte