video-audio-add

Adds an audio track to an existing video. Supports BGM (matched music or a custom audio URL) and voice-over narration; both can be added simultaneously.

meitu video-audio-add

Usage Examples

# Auto-match BGM (required parameters only)
meitu video-audio-add \
  --video_list ./sample.mp4 \
  --prompt "Calm and soothing background music" \
  --json

# Custom audio with volume adjustment
meitu video-audio-add \
  --video_list ./sample.mp4 \
  --audio_url ./bgm.mp3 \
  --prompt "Use the specified audio as BGM" \
  --music_volume 0.5 \
  --video_volume 0.8 \
  --json

# Full parameters with result download
meitu video-audio-add \
  --video_list ./sample.mp4 \
  --audio_url ./bgm.mp3 \
  --prompt "Lively BGM with a male voice-over introduction" \
  --music_volume 0.4 \
  --video_volume 0.9 \
  --json \
  --download-dir ./output

Parameters

ParameterRequiredDescription
--video_listYesType: string[]; list of video URLs
--promptYesType: string; audio requirement description (BGM style, narration content, etc.)
--audio_urlNoType: string; optional custom audio URL for BGM (overrides library matching)
--music_volumeNoType: number; BGM volume, range 0-1
--video_volumeNoType: number; original video audio volume, range 0-1
--download-dirNoType: string; downloads result files to the specified local directory
--outputNoType: string[]; specifies output file paths, mapped in order to data.result.urls
--jsonNoOutputs results in JSON format for script or agent parsing