Video Composer

Compose video with multiple audio tracks and optional subtitles

Video Composer

AI-generated

Summary

Compose video with multiple audio tracks and optional subtitles.

Inputs

  • videoPath (required) — Absolute path to the video file
  • audioInputMode — How to provide the audio files
  • audioFilesArray (required) — Audio files array from previous node; expected format: [{"path": "/path/to/audio.mp3", "time": 0}].
  • pathFieldName (required) — Field name for audio file path in the array (e.g., "path").
  • timeFieldName (required) — Field name for start time in the array (e.g., "time").
  • audioFiles — Audio files to overlay on the video when using manual input.
  • audioVolume — Adjust volume for all overlay audio files in dB. Range: -20 to 20.
  • subtitlePath — Optional subtitle file path (supports .srt, .ass, .ssa, .vtt formats).
  • muteOriginalAudio — Whether to mute the original video audio.
  • outputPath (required) — Absolute path for the output file.

Output shape

a single record

Returns success status, output file path, video path, audio files count, audio volume, subtitle presence, mute original audio flag and video duration.

Examples

Example 1: Overlay audio files from a previous node's output array onto a specified video file, optionally adjusting volume and adding subtitles.

Set videoPath to the video file, audioInputMode to 'fromNode', provide audioFilesArray, set outputPath for the result.

Example 2: Manually specify multiple audio tracks and their respective start times to overlay on a video.

Set audioInputMode to 'manual', use audioFiles to specify audio tracks, and set videoPath and outputPath.

Discussion