Image Format Converter

Convert images between formats with quality control and optimization. This Apify Actor provides a simple, reliable way to transform images for web optimization, batch processing, and automated pipelines.

What does Image Format Converter do?

Image Format Converter processes images from URLs and converts them to your desired format with customizable quality settings. It supports popular formats including JPEG, PNG, WebP, AVIF, GIF, TIFF, BMP, and HEIF.

Key capabilities:

• Convert between 9 image formats
• Quality control from 1-100 for lossy formats
• Automatic format detection from input URLs
• Google Drive link support
• Compression ratio reporting

Why use Image Format Converter?

• Web optimization: Convert images to modern formats like WebP or AVIF for faster page loads
• E-commerce: Standardize product images to consistent formats
• Content management: Prepare images for blogs, social media, and digital platforms
• Batch processing: Integrate into automated workflows via Apify API
• API integration: Use in custom applications requiring on-demand image conversion

How to use Image Format Converter

1. Provide image URL: Enter the direct URL of the image you want to convert
2. Select output format: Choose your desired format (WebP recommended for web)
3. Set quality: Adjust quality from 1-100 (higher = better quality, larger file)

Input

The Actor accepts the following input parameters:

Field	Type	Required	Default	Description
imageUrl	string	Yes	-	URL of the image to convert (max 50MB, max 10,000x10,000px)
outputFormat	string	Yes	webp	Output format: jpeg, jpg, png, webp, gif, avif, tiff, bmp, heif
quality	integer	No	90	Quality 1-100 (applies to lossy formats)

Example input

{
  "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/640px-PNG_transparency_demonstration_1.png",
  "outputFormat": "webp",
  "quality": 85
}

Output

Each processed image produces a result object stored in the dataset:

Field	Type	Description
originalUrl	string	URL of the original image
outputUrl	string	URL of the converted image
originalFilename	string	Original filename
originalFormat	string	Detected input format
targetFormat	string	Output format
originalSize	integer	Original file size in bytes
convertedSize	integer	Converted file size in bytes
compressionRatio	string	Percentage size change
compressionSavings	string	Human-readable size difference
status	string	success or error
processingTime	integer	Processing time in milliseconds
error	string	Error message (if failed)

Example output

{
  "originalUrl": "https://example.com/photo.jpg",
  "originalFilename": "photo.jpg",
  "originalFormat": "JPEG",
  "targetFormat": "WEBP",
  "originalSize": 2457600,
  "convertedSize": 1843200,
  "compressionRatio": "25.00%",
  "compressionSavings": "0.59MB saved",
  "outputUrl": "https://api.apify.com/v2/key-value-stores/abc123/records/photo.webp",
  "outputFilename": "photo.webp",
  "status": "success",
  "processingTime": 1250
}

Pricing

This Actor uses pay-per-event (PPE) pricing at $0.01 per image processed.

How pay-per-event works

• You only pay for successful processing - Errors do not incur charges
• Simple, transparent pricing - One flat rate per image
• Platform costs included - Compute units are covered in the event price
• Spending control - Set a maximum charge limit per run

Cost examples

Images	Cost
1	$0.01
100	$1.00
1,000	$10.00
10,000	$100.00

Spending limits

You can set a maximum spending limit per run in the Apify Console. The Actor will respect this limit and stop processing when reached.

Supported formats

Input formats

JPEG, PNG, WebP, GIF, TIFF, BMP, HEIC, AVIF, and various RAW camera formats

Output formats

Format	Best for	Lossy/Lossless
WebP	Web images, modern browsers	Both
AVIF	Next-gen web, best compression	Both
JPEG	Photographs, universal support	Lossy
PNG	Transparency, logos	Lossless
GIF	Animated images	Lossless
TIFF	Archival, print	Both
BMP	Uncompressed bitmap	Lossless
HEIF	Apple ecosystem	Both

Limitations

• Maximum file size: 50MB
• Maximum dimensions: 10,000 x 10,000 pixels
• BMP output is converted to PNG (Sharp library limitation)

Tips

• Use WebP or AVIF for web images - they offer the best compression
• Set quality to 85-90 for good balance between size and quality
• For PNG images, quality controls compression level (not image quality)
• Use quality 100 with WebP for lossless compression

Integration

API usage

curl -X POST "https://api.apify.com/v2/acts/image-format-converter/runs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://example.com/image.png",
    "outputFormat": "webp",
    "quality": 90
  }'

JavaScript/Node.js

const { ApifyClient } = require("apify-client");

const client = new ApifyClient({ token: "YOUR_API_TOKEN" });

const run = await client.actor("image-format-converter").call({
  imageUrl: "https://example.com/image.png",
  outputFormat: "webp",
  quality: 90,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Support

If you encounter any issues or have questions:

• Check the Apify documentation
• Open an issue on the Actor page
• Contact the developer through Apify Console