What problem does it solve?
Cloudflare Images provides a scalable, API-driven approach to store, transform, and deliver images at scale without maintaining separate image servers. It simplifies image optimization, access control, and delivery across devices with built-in support for variants, signed URLs, and edge caching.
Core Features & Use Cases
- Upload images via API or Direct Creator Upload for centralized storage.
- Transform images on the fly using URL parameters or Workers bindings for dynamic resizing and format changes.
- Manage named variants and optional flexible variants for public or private image delivery.
- Secure access with signed URLs and origin binding to protect private content.
- Integrate with Cloudflare Images on R2 for origin storage and optimized delivery.
- Polish options and billing insights for cost optimization.
Quick Start
Start by uploading an image via the API, then transform it via URL, and manage variants via the dashboard or API.
- Upload an image via API: curl --request POST https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1 --header "Authorization: Bearer <API_TOKEN>" --form file=@./image.jpg
- Transform via URL: https://<ZONE>/cdn-cgi/image/width=400,format=auto/<path-to-image>
- Create or manage a variant via API: curl -X POST https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/variants --header "Authorization: Bearer <API_TOKEN>" --header "Content-Type: application/json" --data '{"id":"thumb","options":{"width":200,"height":200},"neverRequireSignedURLs":false}'