Zum Inhalt
HALOWERK

Medienwerk

topic segments

Takes a recording of up to 120 minutes and returns its topic structure: segments that start where the subject really changes, each with a topic label of up to eight words, keywords, a one-sentence summary, start and end time and the spoken text of the segment. Boundaries are chosen by a language model as sentence numbers only, so they always fall on sentence starts with recogniser timestamps. Maximum number of segments and output language are selectable. Transcription by Deepgram with.

POST https://medien.halowerk.com/v1/topic-segments

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.
languagestringNeinSpoken language (BCP-47). Omit to detect.
output_languagestringNein
max_segmentsintegerNein
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 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": 120,
      "description": "Length in started minutes — this is what you are billed for."
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "Spoken language (BCP-47). Omit to detect."
    },
    "output_language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es",
        "fr",
        "it",
        "nl",
        "pt",
        "pl",
        "tr",
        "sv",
        "da",
        "cs",
        "ru",
        "uk",
        "ja",
        "zh",
        "ko",
        "ar"
      ]
    },
    "max_segments": {
      "type": "integer",
      "minimum": 2,
      "maximum": 40,
      "default": 12
    }
  }
}

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 →