Image Convert

Converts an image to a different format (PNG, JPG, or WebP).

Command

npx agent-media@latest image convert --in <path> --format <format> [options]

Inputs

Option	Required	Description
--in	Yes	Input file path or URL
--format	Yes	Output format: png, jpg, webp
--quality	No	Quality for lossy formats (1-100, default: 80)
--out	No	Output path, filename or directory (default: ./)
--provider	No	Provider to use (default: auto-detect)

Output

Returns a JSON object with the converted image path:

{
  "ok": true,
  "media_type": "image",
  "action": "convert",
  "provider": "local",
  "output_path": "converted_123_abc.webp",
  "mime": "image/webp",
  "bytes": 23456
}

Examples

Convert PNG to WebP:

npx agent-media@latest image convert --in photo.png --format webp

Convert to high-quality JPEG:

npx agent-media@latest image convert --in photo.png --format jpg --quality 95

Convert with custom output directory:

npx agent-media@latest image convert --in image.png --format webp --out ./converted

Providers

• local (default) - Uses sharp library, no API key required