Zum Inhalt
HALOWERK

Medienwerk

stt batch

Takes 2 to 15 recordings by URL or inline base64, each with its declared length, and returns one transcript per file in the order given: full text, detected language, paragraphs, utterances, a confidence summary naming the weakest words with timestamps, and optionally every word with its timing. Billing is per started audio minute across the whole batch, at 0.017 USDC instead of the 0.02 USDC of a single /v1/stt call, at most 60 minutes per call. Every file is fetched and measured locally.

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

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
filesarrayJaThe recordings. Each with source and its length in started minutes.
languagestringNeinBCP-47 code for all files, e.g. en, de. Omit to detect per file. "multi" is not offered in batch.
include_wordsbooleanNeinReturn every word with timestamps per file. Off keeps the response small.
confidence_thresholdnumberNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "files"
  ],
  "additionalProperties": false,
  "properties": {
    "files": {
      "type": "array",
      "minItems": 2,
      "maxItems": 15,
      "description": "The recordings. Each with source and its length in started minutes.",
      "items": {
        "type": "object",
        "required": [
          "source",
          "duration_minutes"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 120,
            "description": "Your own label for this file; returned unchanged."
          },
          "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. All inline files together must stay under the 12 MB request limit; larger batches come by url."
              },
              "filename": {
                "type": "string",
                "maxLength": 260
              }
            }
          },
          "duration_minutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 30,
            "description": "Length of this recording in started minutes."
          }
        }
      }
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "BCP-47 code for all files, e.g. en, de. Omit to detect per file. \"multi\" is not offered in batch."
    },
    "include_words": {
      "type": "boolean",
      "default": false,
      "description": "Return every word with timestamps per file. Off keeps the response small."
    },
    "confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.7
    }
  }
}

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 →