| name | image-convert |
| description | Converts an image to a different format (PNG, JPG, WebP). Use when you need to change image formats, optimize for web, or prepare images for specific applications. |
| compatibility | Requires Node.js 18+. Run via npx agent-media@latest or npm install -g agent-media. |
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
