Batch Video to GIF Conversion

Batch convert individual videos into animated GIFs, with support for transparent-background stickers.

meitu batch video-to-gif

Note: Batch processing is available from meitu-cli v2.1.1 onward. Please upgrade if you're on an older version.

Usage Examples

# Scenario 1: Directory scan mode
meitu batch video-to-gif \
  --input-dir ./videos \
  --output-dir ./gifs \
  --prompt "Standard GIF" \
  --json

# Scenario 2: Config file mode
meitu batch video-to-gif \
  --config ./batch.video-to-gif.yaml \
  --output-dir ./gifs \
  --json

Config File Example

version: 1
defaults:
  outputDir: ./gifs
items:
  - input: ./videos/video1.mp4
    prompt: Standard GIF
  - input: ./videos/video2.mp4
    prompt: Transparent background sticker GIF

Parameter Reference

ParameterRequiredDescription
--input-dirNoInput directory, recursively scan for video files
--output-dirYesOutput directory
--configNoPath to YAML/JSON config file
--concurrencyNoType: number; Default: 3; Number of parallel tasks
--max-retriesNoType: number; Default: 0; Number of retries on failure
--skip-existNoSkip existing output files
--dry-runNoPreview the plan without executing
--no-progressNoDisable per-task progress logging
--jsonNoOutput results in JSON format
--json-outputNoWrite results to a specified JSON file
--skill-nameNoServer-side skill identifier
--promptNoType: string; GIF requirement description (standard/transparent background/sticker, etc.)