Zum Inhalt
HALOWERK

Medienwerk

burn subtitles

Takes a video of up to 3 minutes and returns an MP4 with the subtitles rendered into the picture. Subtitles come either from you as SRT or WebVTT text, or, with transcribe=true, from the soundtrack (Deepgram, training opt-out) at 0.03 instead of 0.01 USDC per minute — the price is fixed before payment. Rendering runs locally with ffmpeg and libass in DejaVu Sans with outline, at the size and position you choose; the video is re-encoded to H.264/AAC and scaled to at most max_width so the file.

POST https://medien.halowerk.com/v1/burn-subtitles

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
sourceobjectJaThe recording. Either url or content_base64.
duration_minutesintegerJaLength of the video in started minutes — this is what you are billed for.
srtstringNeinSubtitles as SRT text.
vttstringNeinSubtitles as WebVTT text.
transcribebooleanNeinCreate subtitles from the soundtrack instead (0.03 USDC per minute).
languagestringNeinSpoken language for transcribe. Omit to detect.
font_sizeintegerNein
positionstringNein
max_widthintegerNein
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": 3,
      "description": "Length of the video in started minutes — this is what you are billed for."
    },
    "srt": {
      "type": "string",
      "maxLength": 300000,
      "description": "Subtitles as SRT text."
    },
    "vtt": {
      "type": "string",
      "maxLength": 300000,
      "description": "Subtitles as WebVTT text."
    },
    "transcribe": {
      "type": "boolean",
      "default": false,
      "description": "Create subtitles from the soundtrack instead (0.03 USDC per minute)."
    },
    "language": {
      "type": "string",
      "maxLength": 12,
      "description": "Spoken language for transcribe. Omit to detect."
    },
    "font_size": {
      "type": "integer",
      "minimum": 10,
      "maximum": 60,
      "default": 22
    },
    "position": {
      "type": "string",
      "enum": [
        "bottom",
        "middle",
        "top"
      ],
      "default": "bottom"
    },
    "max_width": {
      "type": "integer",
      "minimum": 320,
      "maximum": 1920,
      "default": 1280
    }
  }
}

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 →