VideoSailor icon

VideoSailor

Download, transcribe, trim, cut, resize, and add subtitles to videos

Actions8

Subtitles

AI-generated

Summary

Burn subtitles onto a video from a specified media URL using a JSON array of timestamped words and customizable subtitle styling options.

Inputs

  • URL (required) — The URL of the media to overlay subtitles on. Supports YouTube, TikTok, Instagram, Twitter (X), Vimeo, and 1000+ other sites.
  • Subtitle Words (JSON) (required) — A JSON array representing subtitle words with their start and end timestamps in the format [{ "word": "Hello", "start": 0.5, "end": 1.2 }, ...].
  • Subtitle Options — Settings to customize subtitle appearance including horizontal (X) and vertical (Y) position, font size, alignment, font color, stroke color and width, and background color.

Output shape

a JSON object representing the processed video with subtitles burned in

This operation submits the subtitling task asynchronously and polls until completion (up to 15 minutes timeout). It returns the final processed video metadata or error information if the operation fails or times out.

Examples

Example 1: Add subtitles with default styling

Provide media URL and a valid JSON array of subtitle words. Optionally omit subtitle options to use defaults.

Links

Discussion