cloudflare-images

SKILL.md

Store, transform, and deliver images at scale with Cloudflare Images API and URL-based transformations.

Upload images via API, direct creator URLs, or external sources; serve via imagedelivery.net with optional signed URLs for private access

Transform any image on-the-fly using /cdn-cgi/image/ parameters (resize, crop, quality, format auto-detection) or Workers cf.image object

Create up to 100 named variants for common transformations; use flexible variants for dynamic parameters (incompatible with signed URLs)

AI face detection (gravity=face with zoom control) for smart cropping; preserve image provenance with Content Credentials (C2PA standard)

Prevent 16 documented issues including CORS failures, direct upload timeouts, metadata stripping, AVIF resolution limits, and cache behavior quirks

Cloudflare Images

Status: Production Ready ✅
Last Updated: 2026-01-21
Dependencies: Cloudflare account with Images enabled
Latest Versions: Cloudflare Images API v2, @cloudflare/workers-types@4.20260108.0

Recent Updates (2025):

February 2025: Content Credentials support (C2PA standard) - preserve image provenance chains, automatic cryptographic signing of transformations

August 2025: AI Face Cropping GA (gravity=face with zoom control, GPU-based RetinaFace, 99.4% precision)

May 2025: Media Transformations origin restrictions (default: same-domain only, configurable via dashboard)

Upcoming: Background removal, generative upscale (planned features)

Deprecation Notice: Mirage deprecated September 15, 2025. Migrate to Cloudflare Images for storage/transformations or use native <img loading="lazy"> for lazy loading.

Overview