Zum Inhalt
HALOWERK

Medienwerk

audio redact

Takes an audio or video file and returns a new audio file in which sensitive spoken content is covered by a 1 kHz tone or by silence. The recording is transcribed with word timestamps; then fixed, checkable patterns are searched in the words — e-mail addresses, also in spoken form, phone numbers of 7 to 15 digits, IBANs, card numbers that pass the Luhn check, and optionally any number of four or more digits — together with the names and terms you pass in terms, matched word by word.

POST https://medien.halowerk.com/v1/audio-redact

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.
languagestringNeinBCP-47 code of the spoken language. Omit to detect it.
categoriesarrayNeinPattern categories to redact. long_number covers every number of four or more digits and is off by default.
termsarrayNeinNames and terms to redact, matched word by word, case-insensitive. Multi-word terms are allowed.
modestringNein
padding_msintegerNeinMargin added before and after each hit.
output_formatstringNein
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
        },
        "content_base64": {
          "type": "string",
          "maxLength": 12000000
        },
        "filename": {
          "type": "string",
          "maxLength": 260
        }
      }
    },
    "duration_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Length in started minutes — this is what you are billed for."
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "BCP-47 code of the spoken language. Omit to detect it."
    },
    "categories": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "email",
          "phone",
          "iban",
          "card",
          "long_number"
        ]
      },
      "default": [
        "email",
        "phone",
        "iban",
        "card"
      ],
      "description": "Pattern categories to redact. long_number covers every number of four or more digits and is off by default."
    },
    "terms": {
      "type": "array",
      "maxItems": 200,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Names and terms to redact, matched word by word, case-insensitive. Multi-word terms are allowed."
    },
    "mode": {
      "type": "string",
      "enum": [
        "beep",
        "silence"
      ],
      "default": "beep"
    },
    "padding_ms": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000,
      "default": 120,
      "description": "Margin added before and after each hit."
    },
    "output_format": {
      "type": "string",
      "enum": [
        "opus",
        "mp3",
        "wav",
        "flac"
      ],
      "default": "opus"
    }
  }
}

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 →