Batch Video Audio Add
Add background music (BGM) or voiceover narration to videos in batch, with support for adding both sequentially.
meitu batch video-audio-add
Note: Batch processing is available from meitu-cli v2.1.1 onward. Please upgrade if you're on an older version.
Usage Examples
# Config file mode (config file required)
meitu batch video-audio-add \
--config ./batch.video-audio-add.yaml \
--output-dir ./dubbed \
--jsonConfig File Example
version: 1
defaults:
outputDir: ./dubbed
items:
- video: ./videos/video1.mp4
audioUrl: https://example.com/bgm.mp3
prompt: add gentle background music
- video: ./videos/video2.mp4
prompt: Add voiceover narrationParameter Reference
| Parameter | Required | Description |
|---|---|---|
--output-dir | Yes | Output directory |
--config | Yes | Path to YAML/JSON config file (config file required) |
--concurrency | No | Type: number; Default: 3; Number of parallel tasks (recommend 1-2 for video) |
--max-retries | No | Type: number; Default: 0; Number of retries on failure |
--skip-exist | No | Skip existing output files |
--dry-run | No | Preview the plan without executing |
--no-progress | No | Disable per-task progress logging |
--json | No | Output results in JSON format |
--json-output | No | Write results to a specified JSON file |
--skill-name | No | Skill name for server-side attribution |