DEV Community: Roman Klymenko

Node.js Image Compression: A Complete API Integration Guide

Roman Klymenko — Tue, 28 Jul 2026 12:31:04 +0000

Tired of bloated images slowing down your app? Let's fix that with Node.js image compression.

Every KB counts. Uncompressed images can drain bandwidth and kill user experience. An effective image compression API solves this instantly—compress images up to 90% without quality loss.

Here's how to set up image compression in Node.js using a REST API:

const axios = require('axios');
const fs = require('fs');

async function compressImage(imagePath) {
 const imageBuffer = fs.readFileSync(imagePath);

 const response = await axios.post(
 'https://api.pixozip.com/compress',
 imageBuffer,
 {
 headers: {
 'Content-Type': 'image/jpeg'
 }
 }
 );

 fs.writeFileSync('compressed.jpg', response.data);
 console.log('Image compressed successfully!');
}

compressImage('./photo.jpg');

90% compression without visible quality loss
Free image compression API tier available
Works with image resize API features
Perfect for PHP image compression too
Acts as your image CDN alternative

Need batch processing? Use nodejs image compression with async/await:

const files = ['img1.jpg', 'img2.png', 'img3.webp'];
await Promise.all(files.map(compressImage));

Cache compressed results—no need to re-compress

AVIF vs WebP: Which Format Should Developers Choose in 2026?

Roman Klymenko — Tue, 21 Jul 2026 12:31:48 +0000

Feature	AVIF	WebP
Compression	25-35% better	Industry standard
Browser Support	95%+ modern browsers	96%+ coverage
Encoding Speed	Slower	Faster
Quality at Low Bitrate	Excellent	Very good
Animation Support	Yes (AVIC)	Yes
Maturity	Newer, still optimizing	Battle-tested

WebP dominated the last five years. It's fast, widely supported, and genuinely better than JPEG/PNG. Most developers standardized on it and called it a day.

But AVIF changes the equation. It compresses better—often 25-35% smaller than WebP at identical visual quality. For image-heavy sites, that's real performance gain. Real user experience improvement.

The catch? AVIF takes longer to encode. Your build pipeline slows. And fallbacks matter—older browsers still exist, even if they're shrinking.

Here's the practical take for 2026:

Use AVIF as primary, WebP as fallback, JPEG/PNG as safety net. Modern picture elements handle this effortlessly:

<picture>
 <source srcset="image.avif" type="image/avif">
 <source srcset="image.webp" type="image/webp">
 <img src="image.jpg" alt="description">
</picture>

Browser support is now solid enough—95%+ of modern browsers speak AVIF natively. The "too new, too risky" argument doesn't hold anymore.

Start converting your heaviest images.

PNG to WebP: The Complete Developer's Conversion Guide

Roman Klymenko — Thu, 16 Jul 2026 12:43:29 +0000

Quick TL;DR – Convert PNG to WebP in 30 seconds:


convert image.png image.webp

cwebp -q 80 image.png -o image.webp

const sharp = require('sharp');
sharp('image.png').webp({ quality: 80 }).toFile('image.webp');

WebP isn't just hype—it's a legitimate game-changer for web performance. If you're still serving PNG files in 2024, you're leaving ~30-40% file size reduction on the table.

Why PNG to WebP matters:

PNG files are lossless, which is great for quality but brutal on bandwidth. WebP delivers the same visual fidelity at a fraction of the size. A typical PNG converts to WebP with 25-35% compression, sometimes hitting 50%+ on complex images.

The conversion reality:

Quality trade-off: Minimal. Most developers can't spot the difference at quality 75-85.
Browser support: 96%+ of modern browsers. Fallbacks are your friend for legacy users.
Tools that actually work: cwebp (Google's official), ImageMagick, FFmpeg, or Node.js libraries like Sharp.

Real-world impact:

A 500KB PNG becomes ~150KB WebP. On a site with 50 images, that's 17.5MB saved per page load. Multiply by monthly visitors—your hosting bills and user experience both improve.

Best practice: Use WebP as primary with PNG fallback via `<picture

Core Web Vitals & LCP Image Guide — Dev.to Repost

Roman Klymenko — Thu, 16 Jul 2026 12:42:57 +0000

Your images might be killing your LCP score. Here's why: unoptimized images delay the Largest Contentful Paint, tanking your Core Web Vitals and SEO rankings.

The fix? Smart image optimization for web. Before diving into lazy-loading and next-gen formats, compress ruthlessly. Most devs waste 60-80% of image file size unnecessarily.

Three quick wins:

1. Optimize images without losing quality — Modern compressors (like WebP) cut file sizes by 30-50% while keeping visuals sharp. Your users won't notice the difference.

2. Automate it — Manual optimization kills productivity. Automatic image optimization in your build pipeline means every image gets optimized before deployment.

3. Test your LCP — Use PageSpeed Insights. If an image is your LCP element, that's your bottleneck. Prioritize optimizing it.

Image optimization best practices? Start here: measure, compress, format-switch, cache aggressively. Done right, you'll shave 1-2 seconds off page load time alone.

The deeper analysis lives on our blog — check the canonical link for the full breakdown on image optimization for website performance.

TL;DR: Optimize your images. Your Core Web Vitals (and users) will thank you.

Ultimate Guide to Image Compression: Reduce Image Size Without Losing Quality

Roman Klymenko — Thu, 16 Jul 2026 12:42:51 +0000

Tired of images bloating your web projects? Learn how to compress images without sacrificing quality—essential for every developer's toolkit.

Every kilobyte counts. Large unoptimized images slow page load times, kill Core Web Vitals, and frustrate users. Lossless compression removes metadata and redundant data while keeping your visuals pixel-perfect.

Lossless compression preserves all image data—perfect for screenshots, logos, and anything demanding clarity. Lossy compression strategically reduces colors and details, ideal for photos where minor quality loss is invisible.

Choose the right format (WebP beats PNG/JPG)
Resize before compressing
Batch compress to save time
Use online tools for quick workflows
Automate in your build pipeline

Modern online image compressors handle bulk operations instantly. A solid free image compressor should offer batch image compression, preserving quality while slashing file sizes by 50-90%.

Quality compression shrinks a 2MB photo to 300KB with zero visible difference. That's faster loading, happier users, better SEO ranking.

Start optimizing today—your website's performance (and your users) will thank you.

Originally published on pixozip.com/blog

PNG vs WebP vs AVIF — Dev.to Repost

Roman Klymenko — Tue, 07 Jul 2026 12:00:37 +0000

Ever wondered which image format actually saves bandwidth without sacrificing quality? Let's break it down.

PNG is your reliable friend—lossless, great for graphics, but bloated for photos. WebP cuts file sizes by 25-35% and supports transparency. AVIF is the newcomer crushing it with 50%+ smaller files than PNG, but browser support isn't universal yet.

The real win? Use WebP for most cases—solid browser support and size savings. AVIF when you can afford a fallback. PNG for simple graphics or when you need maximum compatibility.

Pro tip: automate this with tools that handle format conversion and serve the right file to the right browser. Your users (and hosting bill) will thank you.

Which format dominates your stack?

How to Automate Image Compression with an API: A Node.js & PHP Guide

Roman Klymenko — Mon, 22 Jun 2026 09:37:05 +0000

Images are still the single heaviest asset on most web pages, and one unoptimized hero shot can wreck your Largest Contentful Paint (LCP) before a line of your JavaScript even runs. The catch is that manual optimization — dragging files through a desktop tool before every deploy — simply does not scale. The moment your users start uploading their own avatars, products, or listings, compression has to happen automatically, on the server, in real time.

That is exactly what an image optimization API is for. In this guide we wire one into a real backend using the Pixozip API, with working Node.js and PHP examples, plus the async patterns you actually need in production.

1. How an Image Optimization API Works

The flow is simpler than it looks. Instead of bundling sharp, libvips, or ImageMagick into every service and fighting native build dependencies in CI, you POST the raw image bytes to a stateless HTTP endpoint and get an optimized file back.

A typical request lifecycle looks like this:

Upload — your backend sends the raw image buffer to POST /v1/shrink.
Queue — the gateway authenticates your API key, validates the payload, and enqueues a job.
Process — a horizontally-scaled worker re-encodes the image to WebP, AVIF, or JPEG XL.
Deliver — you receive metadata plus a short-lived URL to download the optimized bytes.

Because the heavy lifting runs on dedicated workers, your application servers stay light: no CPU spikes from sharp, no memory pressure, and no native modules to compile.

Concern	In-process (sharp/IM)	Optimization API
Native build deps	Required in every image	None
CPU / memory load	On your app servers	Offloaded to workers
Horizontal scaling	Manual	Built-in queue
Modern formats	Manual per-codec	`webp` / `avif` / `jxl`

2. Node.js Integration

The official @pixozip/sdk is dependency-free — it runs on native fetch and streams, so it adds almost nothing to your bundle. Install it:

npm install @pixozip/sdk

Then compress a local file and write the result to disk:

import { Pixozip } from "@pixozip/sdk";
import * as fs from "fs/promises";

const zip = new Pixozip({ apiKey: process.env.PIXOZIP_API_KEY! });

const input = await fs.readFile("original-photo.jpg");

const result = await zip.shrink(input, {
  contentType: "image/jpeg",
  output: "webp",        // "auto" | "webp" | "avif" | "jpeg" | "png" | "jxl"
  qualityTier: "balanced" // "fast" | "balanced" | "max"
});

console.log(`Saved ${Math.round((1 - (result.ratio ?? 1)) * 100)}%`);

const optimized = await result.download();
await fs.writeFile("optimized.webp", optimized);

The result object carries everything you need: jobId, outputBytes, the compression ratio, and a download() helper that fetches the final bytes from the short-lived storage URL. You can also resize on the fly:

await zip.shrink(input, {
  contentType: "image/png",
  output: "avif",
  resize: { width: 1200, fit: "inside" } // cover | contain | fill | inside | outside
});

3. PHP Integration

For Laravel, WordPress, or plain PHP backends, the pixozip/sdk Composer package mirrors the same API:

composer require pixozip/sdk

<?php
use Pixozip\Pixozip;

$zip = new Pixozip(['apiKey' => getenv('PIXOZIP_API_KEY')]);

$bytes = file_get_contents('upload.jpg');

$result = $zip->shrink($bytes, [
    'contentType' => 'image/jpeg',
    'output'      => 'webp',
    'qualityTier' => 'balanced',
]);

// $result is an array: ['jobId' => ..., 'outputBytes' => ..., 'ratio' => ...]
$optimized = $zip->download($result['downloadUrl']);
file_put_contents('optimized.webp', $optimized);

Both SDKs throw a typed error (PixozipError in Node, PixozipException in PHP) that exposes the HTTP status and the gateway body so you can branch on rate_limit_exceeded, file_too_large, and friends.

4. Raw REST — No SDK Required

Under the hood it is just one authenticated POST. The image goes in the request body as raw bytes; the options ride along in an x-options JSON header:

curl -X POST https://api.pixozip.com/v1/shrink \
  -H "Authorization: Bearer img_live_your_key" \
  -H "Content-Type: application/octet-stream" \
  -H 'x-options: {"output":"webp","qualityTier":"balanced"}' \
  --data-binary @photo.jpg

This portability is the whole point of an API: any language that can make an HTTP request — Go, Python, Ruby, Rust — can optimize images with no native dependencies at all.

5. Going Async at Scale

Synchronous calls are perfect for single uploads, but for batch imports or large payloads you should not hold an HTTP connection open while a worker grinds. Pass async: true and the API returns instantly with a jobId you poll:

const job = await zip.shrink(input, { contentType: "image/jpeg", async: true });

let status = job;
while (status.status === "queued" || status.status === "processing") {
  await new Promise(r => setTimeout(r, 1000));
  status = await zip.getJob(job.jobId);
}

if (status.status === "completed") {
  await fs.writeFile("out.webp", await status.download());
}

Two more endpoints make life easier: POST /v1/shrink-from-url pulls a remote image directly (no need to buffer it yourself), and POST /v1/srcset returns a full set of responsive variants in one call — ideal for feeding a <picture> element.

6. Production Best Practices

Always send an idempotencyKey. Network retries are inevitable; an idempotency key guarantees a flaky connection never bills you — or processes the same image — twice.
Use output: "auto" to let the API negotiate the best modern format per image instead of hard-coding one.
Strip metadata by default. Leave keepMetadata off unless you genuinely need EXIF/GPS — it shaves extra bytes and removes a privacy leak.
Go async for anything batch. Queue-and-poll keeps your request workers free and your timeouts sane.
Start free. Every account gets 500 optimizations per month at no cost, and an unauthenticated POST /v1/public/shrink endpoint allows 5 test compressions per IP per day — enough to prototype before you ever add a key.

Conclusion

Build-time tooling optimizes the images you ship. An API optimizes the images everyone else uploads — automatically, at scale, without dragging native codecs into your stack. With a dependency-free SDK for Node.js and PHP and a plain REST endpoint for everything else, wiring it in is a single function call.

Grab a free API key, keep your 500 monthly optimizations, and stop shipping heavy images. Start with Pixozip →

How to Build a High-Performance Image Optimization Pipeline in 5 Minutes

Roman Klymenko — Mon, 25 May 2026 14:22:09 +0000

Images make up over 60% of average web page weight. If you're serving unoptimized, raw JPEGs or PNGs to mobile clients, your site's Largest Contentful Paint (LCP) score is taking a massive hit.

In this quick guide, we’ll show you how to automate image compression using the Pixozip SDK to convert images to AVIF/WebP on the fly.

Why AVIF over traditional JPEG?

Traditional JPEG compression is linear. AVIF uses intra-frame video compression algorithms that analyze texture patterns. This allows AVIF to shrink file sizes by 70-90% compared to legacy JPEG while keeping the same visual clarity.

Step 1: Install the SDK

Install the official Node.js SDK:

npm install @pixozip/sdk

Step 2: Initialize and Compress

Import the library, supply your API key, and call the .shrink() method. It handles error catching, request formatting, and automatic retries with exponential backoff internally:

import { Pixozip } from "@pixozip/sdk";
import * as fs from "fs/promises";

const zip = new Pixozip({ apiKey: "YOUR_API_KEY" });

// Load the image file into a buffer
const imageBuffer = await fs.readFile("./hero_banner.png");

// Compress and convert to AVIF
const result = await zip.shrink(imageBuffer, {
  contentType: "image/png",
  output: "avif",           // Automatically converts png to avif
  qualityTier: "balanced",  // Targets visually lossless quality (SSIM > 0.995)
  resize: { width: 1200 }   // Scales down layout resolutions
});

// Download and write the optimized image
const optimizedBuffer = await result.download();
await fs.writeFile("./hero_banner.opt.avif", optimizedBuffer);

console.log(`Optimized! Saved ${Math.round((1 - (result.ratio ?? 1)) * 100)}% of bytes.`);
console.log(`Download URL: ${result.downloadUrl}`);

Async Operations for High Volume

If you are processing batches of images, blocking your server thread synchronously is not ideal. You can trigger an asynchronous job and receive a webhook callback when it's done:

const job = await zip.shrink(imageBuffer, {
  contentType: "image/jpeg",
  output: "webp",
  async: true // Gateway returns 202 immediately
});

console.log(`Job queued with ID: ${job.jobId}`);

Conclusion

By adding a few lines of code to your upload pipeline, you can drastically decrease bandwidth consumption, reduce AWS S3 storage bills, and improve page speed rankings.

Get a free API key with 500 free optimizations per month at pixozip.