{"uid":"cap_YhonjGr-d2_J2EFUboSrV","slug":"halowerk-video-subtitle-mux-688072f0","name":"HALOWERK Video Subtitle Mux","description":"Takes a video (up to 24 MB) and one to five SRT or WebVTT subtitle texts with language codes, and returns the video with each as a separate, switchable subtitle track tagged with its language, the first marked default. Picture and sound are copied, not re-encoded, so quality is unchanged and it is fast. MP4 uses mov_text (plays in QuickTime, browsers with players, most phones); MKV uses SRT tracks (VLC, mpv, Plex). Unlike /v1/burn-subtitles nothing is drawn into the picture.","url":"https://medien.halowerk.com/v1/video-subtitle-mux?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"source":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"filename":{"type":"string","maxLength":260},"content_base64":{"type":"string","maxLength":11000000}},"additionalProperties":false},"container":{"enum":["mp4","mkv"],"type":"string","default":"mp4"},"subtitles":{"type":"array","items":{"type":"object","required":["text","language"],"properties":{"text":{"type":"string","maxLength":400000,"minLength":10},"title":{"type":"string","maxLength":60},"language":{"enum":["de","en","fr","es","it","nl","pt","pl","tr","sv","da","cs","ru","uk","ja","zh","ko","ar"],"type":"string"}},"additionalProperties":false},"maxItems":5,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lUTnkfxQWKYSxokof-d6r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Muxes one to five SRT/WebVTT subtitle tracks with language codes into an MP4 or MKV video file as separate, switchable subtitle tracks without re-encoding picture or audio.","exampleAgentPrompt":"Take this MP4 video (here's the URL: https://example.com/myvideo.mp4) and embed two subtitle tracks into it — one in English and one in German using the SRT texts I'll provide — and give me back an MP4 where viewers can switch between them without anything being burned into the picture.","exampleUseCases":[{"title":"Multilingual course video packaging","prompt":"I have a lecture video at https://cdn.myschool.com/lecture1.mp4 and I've got SRT subtitle files in English, French, and Spanish. Can you mux all three as separate selectable subtitle tracks into an MP4 so students can pick their language? Don't burn anything into the video."},{"title":"Accessibility track for podcast video","prompt":"Please attach this English closed-caption SRT text as a switchable subtitle track to my podcast video — I'll send it as base64 — and output it as an MP4. The subtitles should be marked as the default track."},{"title":"Plex library MKV with multiple subs","prompt":"I want to package my MKV movie with subtitle tracks in English, Japanese, and Korean using the SRT texts I have. Can you mux them all in without re-encoding the video or audio so it plays perfectly in Plex with language switching?"}],"resultDescription":"Returns the original video file (MP4 or MKV container) with the provided subtitle texts embedded as separate, named, language-tagged subtitle streams. The first subtitle is marked as the default track. For MP4, subtitles use the mov_text codec (compatible with QuickTime, browsers, and mobile players); for MKV, subtitles are SRT tracks (compatible with VLC, mpv, Plex). Video and audio streams are stream-copied, so quality is identical to the input and processing is fast.","failureModes":["Video file exceeds 24 MB limit — request rejected","Subtitle text too short (under 10 characters) or too long (over 400,000 characters)","Unsupported language code provided — only 18 languages supported","More than 5 subtitle tracks requested","Invalid SRT or WebVTT format in subtitle text","Source URL unreachable or returning non-video content","base64 payload malformed or exceeds size limit","Unsupported input video codec that cannot be stream-copied into the target container","Payment not provided or insufficient (x402 payment required at $0.004 USDC)"],"whenToPreferThis":"Choose this endpoint when you need to embed soft, switchable subtitle tracks into a video container without altering picture or audio quality. It is ideal for multilingual distribution (up to 5 language tracks), accessibility use cases, and scenarios where end-users need to toggle subtitles on/off in their player. Prefer MP4 output for web, mobile, and QuickTime compatibility; prefer MKV for media server environments like Plex or VLC. Use this instead of /v1/burn-subtitles whenever subtitles must remain optional and not permanently drawn into the picture.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:47.111Z","isFirstParty":false,"canonicalSlug":"halowerk-video-subtitle-mux-688072f0"}