Alex Spinov

Posted on Mar 27

Cloudinary Has a Free API — Transform, Optimize, and Deliver Images and Videos Without Paying

#javascript #webdev #api #tutorial

Most developers still upload images to S3, write resize logic, and pray their CDN caches correctly.

Meanwhile, Cloudinary gives you a free API that handles upload, transformation, optimization, and delivery — all from a single URL.

No credit card required. 25GB storage + 25GB bandwidth/month on the free plan.

What You Get for Free

25 credits/month (~25GB storage + 25GB bandwidth)
Image transformations — resize, crop, blur, watermark, face detection
Video transformations — trim, transcode, generate thumbnails
Auto-format delivery — serves WebP/AVIF based on browser support
Global CDN — automatic caching and delivery from edge locations
AI features — background removal, auto-tagging, content-aware crop

Quick Start (Under 2 Minutes)

Upload an Image

curl https://api.cloudinary.com/v1_1/YOUR_CLOUD/image/upload \
  -X POST \
  -F "file=@photo.jpg" \
  -F "upload_preset=YOUR_PRESET"

Transform via URL

The magic of Cloudinary is URL-based transformations. No code needed:

# Original
https://res.cloudinary.com/YOUR_CLOUD/image/upload/photo.jpg

# Resize to 300x300, smart crop on face
https://res.cloudinary.com/YOUR_CLOUD/image/upload/w_300,h_300,c_fill,g_face/photo.jpg

# Convert to WebP, quality 80
https://res.cloudinary.com/YOUR_CLOUD/image/upload/f_webp,q_80/photo.jpg

# Blur background, keep subject
https://res.cloudinary.com/YOUR_CLOUD/image/upload/e_background_removal/photo.jpg

Node.js SDK

import { v2 as cloudinary } from "cloudinary";

cloudinary.config({
  cloud_name: "YOUR_CLOUD",
  api_key: "YOUR_KEY",
  api_secret: "YOUR_SECRET",
});

// Upload
const result = await cloudinary.uploader.upload("photo.jpg", {
  folder: "blog",
  transformation: [
    { width: 800, crop: "limit" },
    { quality: "auto", fetch_format: "auto" }
  ]
});

console.log(result.secure_url);

Python SDK

import cloudinary
import cloudinary.uploader

cloudinary.config(
    cloud_name="YOUR_CLOUD",
    api_key="YOUR_KEY",
    api_secret="YOUR_SECRET"
)

result = cloudinary.uploader.upload("photo.jpg",
    folder="products",
    transformation=[
        {"width": 600, "crop": "limit"},
        {"quality": "auto", "fetch_format": "auto"}
    ]
)
print(result["secure_url"])

Real-World Use Cases

E-commerce product images: Upload once, serve responsive sizes with w_auto,dpr_auto — saves 40-70% bandwidth vs serving originals.

User avatars: Smart crop with face detection: c_thumb,g_face,w_150,h_150 — no manual cropping needed.

Blog cover images: Auto-optimize with q_auto,f_auto — Cloudinary picks the best format and quality for each browser.

Social media previews: Generate OG images on-the-fly: w_1200,h_630,c_fill — perfect dimensions every time.

What a Startup Founder Told Me

A friend running an e-commerce startup was spending $400/month on image processing infrastructure — Lambda functions for resizing, S3 for storage, CloudFront for delivery. He switched to Cloudinary free tier and it handled everything. He did not need to upgrade until he hit 50K monthly active users.

Limits on Free Plan

Feature	Free Tier
Credits	25/month
Storage	~25 GB
Bandwidth	~25 GB
Transformations	Unlimited (within credits)
AI features	Limited
Video	Up to 10 sec processing

The Bottom Line

If you are still writing image resize code or paying for separate CDN + storage + processing — you are overengineering it.

Cloudinary free tier handles what most apps need until you are well past MVP stage.

Need to extract images from websites at scale? Check out my web scraping tools on Apify — extract product images, screenshots, and media from any site automatically.

Building something custom? Email me at spinov001@gmail.com

DEV Community