Audio & Subtitles

Each page in your template can have multiple audio tracks and subtitles. These are configured directly in the Studio editor and are automatically included when you render the template as a video.

Adding Audio#

Click the speaker icon in the timeline bar below the canvas to open the audio panel.

Upload#

Drag and drop or click to upload an audio file. Supported formats: .mp3, .wav, .m4a, .ogg, .aac (max 10 MB).

Once uploaded, the audio appears in the timeline and is attached to the current page.

Multiple Audio Tracks#

Each page supports multiple audio tracks — for example, background music and a voiceover. Click Add Audio Track in the audio panel to add another track. Each track has independent controls for volume, trim, offset, fade, loop, and mute.

The maximum number of audio tracks per page depends on your plan. Tracks are shown as collapsible sections in the audio panel and as separate bars in the timeline.

Audio Controls#

Timeline#

When audio is attached, a draggable bar appears in the expanded timeline. You can:

• Drag to reposition the audio (changes the offset)
• Resize edges to adjust trim points
• Hold and drag to slip-edit (shift the audio content within the trim window)

How Audio Renders#

All audio tracks on a page are automatically mixed into the video output alongside any audio from video elements on the same page.

• videoOptions.muted: true mutes everything, including all audio tracks
• When muted is not set or false, audio tracks are included automatically
• Volume, trim, offset, fade, and loop settings are all applied per track during rendering
• Use videoOptions.audioSource to override or add audio URLs at render time via the API

Adding Subtitles#

Click the closed captioning icon in the timeline bar to open the subtitle panel.

Upload SRT#

Click Upload SRT to attach a subtitle file. Supported formats: .srt, .vtt.

The file is parsed and the cue count is shown in the panel.

Auto-Generate from Audio#

If the page has audio attached, click Generate from audio to auto-transcribe the audio using OpenAI Whisper. This creates subtitles from the page's audio track.

Subtitle Controls#

Word-by-Word Mode#

Set Display to Word by word to reveal each word at the moment it is spoken or sung, the style used in lyric videos on TikTok and Reels. Pair it with the Center position and a transparent background for the classic look. Word timing is generated during rendering: audio sources are transcribed with word-level timestamps, and uploaded SRT/VTT files get word timings spread across each cue. If transcription mishears song lyrics, upload an SRT with the correct lyrics instead.

How Subtitles Render#

Page-level subtitles are used automatically when rendering videos. If you also pass a videoOptions.subtitleSource in the API request, it takes priority over the page-level subtitle.

Subtitle styles configured in the editor are applied during rendering. API-level videoOptions.subtitle* properties (like subtitleColor or subtitleFontSize) override the page-level styles when provided.

Multi-Page Templates#

Each page has its own independent audio tracks and subtitle configuration. When rendering a multi-page video slideshow with videoOptions.combinePages: true, each page's audio tracks and subtitles are included in its segment of the final video.

API Reference#

Page audio tracks and subtitles work automatically when you render a video. For API-level overrides and additional options, see:

• Video Options — audioSource override, global audio muting, subtitle styling overrides
• Adding Subtitles — API-level subtitle sources and styling
• Template Anatomy — page audioTracks and subtitle object schemas