Image Convert

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

Command

agent-media 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:

agent-media image convert --in photo.png --format webp

Convert to high-quality JPEG:

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

Convert with custom output directory:

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

Providers

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

image-convert

SKILL.md

Image Convert

Command

Inputs

Output

Examples

Providers

Repository

Repository Stats