Batch Image Editing

Edits existing images or creates new ones in batch, supporting e-commerce product images, portrait editing, multi-image consistent editing, general editing, and reference-image-based creation.

meitu batch image-edit

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 is required)
meitu batch image-edit \
  --config ./batch.image-edit.yaml \
  --output-dir ./outputs \
  --json

Config File Example

version: 1
defaults:
  outputDir: ./outputs
items:
  - input: ./images/base1.jpg
    prompt: White background e-commerce main image
  - input: ./images/base2.jpg
    reference: ./images/ref2.jpg
    prompt: Incorporate design elements from the reference into the base image
  - input: ./images/base3.jpg
    prompt: Portrait beauty retouching

Parameter Reference

ParameterRequiredDescription
--output-dirYesOutput directory
--configYesPath to YAML/JSON config file (config file is required)
--concurrencyNoType: number; Default: 3; Number of concurrent executions
--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-nameNoSkill name attributed on the server side