Zum Inhalt
HALOWERK

Medienwerk

video digest

Takes a video by URL or inline base64 and returns what an agent needs to work with it without watching it. The soundtrack is transcribed with paragraphs and timestamps; scene changes are detected with ffmpeg; chapters are cut at paragraph starts, preferring those within three seconds of a visual cut, at least min_chapter_seconds apart and at most 20. Per chapter the answer gives start, end, the spoken text, a title of up to eight words and a one-sentence summary, and optionally a JPEG.

POST https://medien.halowerk.com/v1/video-digest

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
sourceobjectJaThe video. Either url or content_base64.
duration_minutesintegerJaLength of the video in started minutes — this is what you are billed for.
languagestringNeinBCP-47 code of the spoken language. Omit to detect it. Titles and summaries are written in this or the detected language.
min_chapter_secondsnumberNein
include_thumbnailsbooleanNein
thumbnail_widthintegerNein
scene_thresholdnumberNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "source",
    "duration_minutes"
  ],
  "additionalProperties": false,
  "properties": {
    "source": {
      "type": "object",
      "additionalProperties": false,
      "description": "The video. 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 of the video 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. Titles and summaries are written in this or the detected language."
    },
    "min_chapter_seconds": {
      "type": "number",
      "minimum": 10,
      "maximum": 600,
      "default": 45
    },
    "include_thumbnails": {
      "type": "boolean",
      "default": true
    },
    "thumbnail_width": {
      "type": "integer",
      "minimum": 64,
      "maximum": 640,
      "default": 320
    },
    "scene_threshold": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 0.9,
      "default": 0.35
    }
  }
}

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 →