Zum Inhalt
HALOWERK

Medienwerk

audio search

Takes 1 to 15 recordings, each with its declared length (together at most 60 minutes), and up to 25 search terms or phrases. All files are transcribed with word timestamps, then every term is searched word by word, ignoring case and punctuation. Each hit carries the file, start and end time and eight words of context on either side. Single search words of five letters or more also match spellings with one differing letter, marked fuzzy, because that is exactly where the recogniser may have.

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

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
filesarrayJa
queriesarrayJa
languagestringNeinSpoken language for all files (BCP-47). Omit to detect.
fuzzybooleanNein
include_transcriptsbooleanNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "files",
    "queries"
  ],
  "additionalProperties": false,
  "properties": {
    "files": {
      "type": "array",
      "minItems": 1,
      "maxItems": 15,
      "items": {
        "type": "object",
        "required": [
          "source",
          "duration_minutes"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 120
          },
          "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 file."
              },
              "content_base64": {
                "type": "string",
                "maxLength": 12000000,
                "description": "The file inline, base64. Larger files by url."
              },
              "filename": {
                "type": "string",
                "maxLength": 260
              }
            }
          },
          "duration_minutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 30
          }
        }
      }
    },
    "queries": {
      "type": "array",
      "minItems": 1,
      "maxItems": 25,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 120
      }
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "Spoken language for all files (BCP-47). Omit to detect."
    },
    "fuzzy": {
      "type": "boolean",
      "default": true
    },
    "include_transcripts": {
      "type": "boolean",
      "default": false
    }
  }
}

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 →