Skip to content
HALOWERK

Media and Speech Processing

stt short

Speech to text for short clips: transcribe an audio or video recording of up to 60 seconds, sent as base64 file upload or public URL (mp3, wav, m4a, aac, ogg, opus, flac, mp4, webm), at a fixed 0.01 USDC per call. Returns the transcript with punctuation, detected or requested language, utterances, word timestamps and confidence values. The length is measured first; a longer file is refused and not charged. Longer files: /v1/stt. Many files: /v1/stt-batch.

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
sourceobject, stringNoThe recording, at most 60 seconds: an object with url or content_base64, or a URL string.
audio_urlstringNoShorthand for source.url.
urlstringNoShorthand for source.url.
content_base64stringNoShorthand for source.content_base64.
audio_base64stringNoShorthand for source.content_base64.
filenamestringNoFile name for a shorthand base64 upload.
languagestringNoBCP-47 code such as en, de, es, fr. Omit to detect the language automatically. Multilingual mode is not offered on this fixed-price path; use /v1/stt with language "multi".
include_wordsbooleanNoReturn every word with start, end and confidence. Off returns text, utterances and paragraphs only.
duration_minutesnumberNoAccepted for compatibility with /v1/stt request bodies and ignored: the price is fixed and the length is measured.
duration_secondsnumberNoAccepted and ignored; the length is measured.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "source": {
      "type": [
        "object",
        "string"
      ],
      "additionalProperties": false,
      "description": "The recording, at most 60 seconds: an object with url or content_base64, or a URL string.",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048,
          "description": "Public http(s) URL of the audio or video file."
        },
        "content_base64": {
          "type": "string",
          "maxLength": 11500000,
          "description": "The file as base64 upload (a data: URI prefix is accepted), at most 8 MB decoded."
        },
        "filename": {
          "type": "string",
          "maxLength": 260,
          "description": "Optional file name; helps format detection."
        }
      }
    },
    "audio_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Shorthand for source.url."
    },
    "url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Shorthand for source.url."
    },
    "content_base64": {
      "type": "string",
      "maxLength": 11500000,
      "description": "Shorthand for source.content_base64."
    },
    "audio_base64": {
      "type": "string",
      "maxLength": 11500000,
      "description": "Shorthand for source.content_base64."
    },
    "filename": {
      "type": "string",
      "maxLength": 260,
      "description": "File name for a shorthand base64 upload."
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "BCP-47 code such as en, de, es, fr. Omit to detect the language automatically. Multilingual mode is not offered on this fixed-price path; use /v1/stt with language \"multi\"."
    },
    "include_words": {
      "type": "boolean",
      "default": true,
      "description": "Return every word with start, end and confidence. Off returns text, utterances and paragraphs only."
    },
    "duration_minutes": {
      "type": "number",
      "description": "Accepted for compatibility with /v1/stt request bodies and ignored: the price is fixed and the length is measured."
    },
    "duration_seconds": {
      "type": "number",
      "description": "Accepted and ignored; the length is measured."
    }
  }
}

Open original schema

Published input example

{
  "source": {
    "url": "https://medien.halowerk.com/beispiel/interview.mp3"
  },
  "language": "en"
}

Result & documentation

Show published result schema
{
  "$ref": "https://medien.halowerk.com/v1/stt-short/schema#/outputSchema"
}

Open published result example

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-19 UTC.

More endpoints in this hub

All endpoints in this hub →