Subtitle Burn In.

Subtitle Burn In Overview

Subtitle Burn-In renders your subtitle file directly onto a video, embedding captions permanently for silent-autoplay feeds and social clips.

This operation permanently renders supplied subtitle text or a subtitle file onto the source video.

Subtitle Burn In is available through each::labs in the Video-API family. Required fields are video.

subtitle_text: Subtitle text to burn into the video. subtitle_file_url: URL of the subtitle file to burn into the video.

Use the Subtitle Burn In API when you need this transformation or analysis as a repeatable step in an application or creative pipeline. The sections below distinguish the required material, adjustable controls and checks that matter before delivery.

Capabilities

• This operation permanently renders supplied subtitle text or a subtitle file onto the source video.
• subtitle_text: Subtitle text to burn into the video.
• subtitle_file_url: URL of the subtitle file to burn into the video.
• font: Font used for the burned-in subtitles.
• video: URL of the source video file.

Use Cases for Subtitle Burn In

Subtitle Burn In is useful when this specific operation fits between source preparation and delivery. These scenarios show how it can support different parts of a working pipeline.

Creators

Publish captions that remain visible during silent playback. Use a representative source or a concise brief, then inspect the result before preparing a larger set of assets.

Design and marketing teams

Embed translated subtitles. Compare the result with the intended message, composition and destination. Keep reviewable versions of the source and output.

Developers

Prepare an accessible review copy with visible text. Inspect the actual returned value before connecting it to another step, and keep the chosen request settings with the result.

Start with a clear definition of the desired result and use the exposed controls to reach it. Keep any additional generation, editing or application logic in separate steps so that the effect of this operation remains easy to review.

Tips and Tricks

Keep an untouched source file and verify its duration, dimensions and streams before choosing edit settings. Make one small representative request, inspect the returned asset, and use the same settings only when they fit the remaining material.

• subtitle_file_url: URL of the subtitle file to burn into the video.
• font: Font used for the burned-in subtitles.

Set the named operation controls directly. This entry has no general creative-prompt interface; supplying an invented prompt field will not replace a required source or numeric setting.

Compare one deliberate adjustment at a time. Inspect the part of the result affected by that change, then check the rest of the asset or response for unwanted side effects before reusing the settings.

Technical Specifications

• Result type: video.
• Required fields: video.
• font_size: number; default 48; minimum 1.
• subtitle_text: string.
• subtitle_file_url: string.
• font: string; options Anton, Archivo Black, Bangers, Montserrat, Poppins, Inter, TikTok Sans, Liberation Sans; default "Montserrat".

video: URL of the source video file.

Values must use the types and accepted options listed in the parameter reference. A displayed default does not remove a required-field requirement. Choose a supported output setting for this entry rather than borrowing a preset from a related model.

Things to Be Aware Of

Check the processed asset in the actual destination player or editor. Review the opening, closing, sound, crop and any transition points relevant to this operation instead of assuming a successful job proves the edit is correct.

Optional settings are not necessarily interchangeable with those on another entry in the same family. Use the accepted names, types and values shown for this operation.

For media-based inputs, supply a directly retrievable file URL rather than a page containing the asset. Keep the source available while processing. Check the final content in the destination player, editor or application, not only the request status.

Key Considerations

The outer schema does not require a subtitle field, but a meaningful captioning request needs supplied subtitle content; this is not automatic transcription.

Public estimate: $0.00209 per processing second.

Prepare video before starting. Optional settings include subtitle_text, subtitle_file_url, font. Keep these settings aligned with the intended delivery, especially when a later step expects a particular type or format.

Run a representative request before scaling to a larger collection. Judge the result against the source and the brief, and account for all generated outputs or usage-sensitive options when estimating a batch.

Limitations

• font: allowed values: ["Anton", "Archivo Black", "Bangers", "Montserrat", "Poppins", "Inter", "TikTok Sans", "Liberation Sans"].
• font_size: minimum: 1.

Unsupported parameters do not establish additional capabilities. Source quality and the chosen settings constrain what a processing step can deliver. Keep the source and check the result before replacing a final asset.