- Get Started
- Image & Video APIs overview
- Developer kickstart
- SDK quick starts
- AI agent tools and MCP servers
- Try it!
- VS Code Extension (Beta)
- Video tutorial library
- Programmatic asset management
- Image onboarding
- Programmatic upload
- Upload programmatically
- Upload with Fetch API
- Create upload presets (Node.js)
- Create upload presets (Console UI)
- Auto upload
- Moderate images with AI
- Use AI to generate image captions
- Upload images in Flutter
- Upload images in Node.js
- Auto-tag images in Node.js
- Upload multiple files in Node.js
- Upload videos in Node.js
- Upload images in Python
- Auto-tag images in Python
- Upload videos in Python
- Upload images in PHP
- Upload images in Go
- Upload assets in a React app
- Upload assets in a Vue.js app
- Drag-and-drop uploads in React
- Upload assets in a Next.js app
- Upload assets with Server Actions
- Upload assets in Svelte
- Upload assets in a SvelteKit app
- Upload assets in a Remix app
- Upload images in Astro
- Upload images in Hono
- Use webhooks to remove backgrounds
- Upload images in Laravel
- Interaction with Cloudinary APIs
- Cloudinary SDKs
- Find your credentials
- Configure the JavaScript SDK
- Configure the React SDK
- Configure the Angular SDK
- Configure the Flutter SDK
- Configure Svelte Cloudinary
- Configure the Javascript SDK in Svelte
- Getting started with Cloudinary in Node.js
- Configure the Node.js SDK
- Configure the Python SDK
- Configure the PHP SDK
- Install and configure Laravel SDK
- Configure the Go SDK
- Configure the Vue.js SDK
- Configure the Next.js SDK
- List images in Next.js
- Lazy load images with Next.js
- Image fallbacks in JavaScript
- Captioning on upload with Node.js
- Create PDFs from images in Node.js
- Delete assets with Node.js
- Manage images in a Django app
- Image gallery with Astro
- Cloudinary CLI
- Widgets and tools
- Optimization and delivery
- Transformations
- Get started with transformations
- Advanced transformation features
- Text overlay transformations
- Add watermarks in JavaScript
- Complex transformations
- Named transformations
- Named transformations using TX Builder
- Advanced image components
- Trim videos in Node.js
- Splice videos in Node.js
- Zoompan effect
- Video transformations
- Crop and resize images in React
- Crop and resize videos in React
- Crop and resize images in Python
- Remove backgrounds and add drop shadows
- AI generative fill in Next.js
- Color accessibility in JavaScript
- Transformations for social media
- Dev Hints on YouTube
- Dev Hints en Español
- Cloudinary Café Training Sessions
- Programmatic asset management
- Additional onboarding resources
- Guides
- Cloudinary Image
- Product overview
- Image transformations
- Image transformations overview
- Resizing and cropping
- Placing layers on images
- Effects and enhancements
- Background removal
- Generative AI transformations
- Face-detection based transformations
- Custom focus areas
- Transformation refiners
- Animated images
- Transformations on 3D models
- Conditional transformations
- User-defined variables and arithmetic transformations
- Custom functions
- Image optimization and delivery
- Programmatic image creation
- Product Gallery widget
- Media Editor widget
- Image add-ons
- Troubleshooting and tips
- Troubleshooting image transformation errors
- 40x errors and X-Cld-Error messages
- Add a solid color overlay
- Images delivered without gzip compression
- Long time to first byte (TTFB) on WebPageTest.org
- Update a named transformation
- Cloudinary vs Imagga cropping
- Placeholder images (LQIP)
- How to detect corrupted images
- Force specific image when sharing links on Facebook
- Blurry images
- Offset face-detection gravity
- Cloudinary Video
- Product overview
- Cloudinary Video Player
- Video Player features
- Installation and setup
- How to embed the Video Player
- Video Player Studio
- Video Player customization
- Playlists and recommendations
- HLS and MPEG-DASH
- Video Player accessibility
- Video Player advanced features
- Video Player API reference
- Player profiles API reference
- Video config API reference
- Adaptive bitrate streaming
- Video transformations
- Video and audio optimization
- Video transcription
- Video analytics
- Live streaming
- Video add-ons
- Video best practices
- Social media videos
- Troubleshooting and tips
- Upload
- Asset management
- CRUD asset management APIs
- Media Library for developers
- Search for assets
- Eager and incoming transformations
- Custom metadata
- Analyze assets
- Moderate assets
- Webhook notifications
- Advanced asset management
- Add-ons
- Troubleshooting and tips
- Admin API authentication issues
- Why has the public ID of my asset changed?
- Check resource type and delivery type
- Get image or video dimensions
- Download account assets
- Delete or modify original images
- Does Cloudinary store any cookies?
- Underscores in public IDs or folder names
- Update already fetched asset
- Upload, manage, and deliver PDFs
- Cloudinary "sample" images
- Avoiding duplicate uploads
- Permitted naming conventions
- Adult/NSFW content policy
- High transformation rate
- Account management
- Retail and e-commerce
- User-generated content
- Accessible media
- AI in action
- Native mobile
- Add-ons
- Advanced Facial Attributes Detection
- Amazon Rekognition AI Moderation
- Amazon Rekognition Video Moderation
- Amazon Rekognition Auto Tagging
- Amazon Rekognition Celebrity Detection
- Aspose Document Conversion
- Cloudinary AI Background Removal
- Cloudinary AI Content Analysis
- Cloudinary AI Vision
- Cloudinary Duplicate Image Detection
- Google AI Video Moderation
- Google AI Video Transcription
- Google Auto Tagging
- Google Automatic Video Tagging
- Google Translation
- Imagga Auto Tagging
- Imagga Crop and Scale
- Perception Point Malware Detection
- Microsoft Azure Video Indexer
- OCR Text Detection and Extraction
- Pixelz - Remove the Background
- URL2PNG Website Screenshots
- VIESUS™ Automatic Image Enhancement
- WebPurify Image Moderation
- Cloudinary Image
- References
- SDKs
- Release Notes
Why does my account's usage report show a relatively high transformation rate?
Install Cloudinary Agent Skills
Cloudinary agent skills give your AI coding assistant first-class context for working with Cloudinary.
Run to install or update the skills:
Last updated: May-28-2026
Each newly processed asset, original upload, and transformation counts toward your transformation usage. For more information see: How are transformations counted?
The following operations and features may result in unintentional transformation usage:
- Initial migration: This process usually entails a high volume of uploads.
- Repeat uploads: Misconfigured upload scripts that repeatedly upload the same asset may result in additional transformation charges. If the script uses the same public ID for each upload, the existing asset is overwritten instead of creating additional assets.
- Failing uploads: Corrupted or invalid files may fail during processing, sometimes after transformation processing has already begun. In these cases, the upload may still count toward your transformation usage.
- Default images: Incorrect use of the default image placeholder feature may create unnecessary placeholder images that count toward your transformation usage. For example, repeated requests for an image before it has been uploaded may generate placeholder images unnecessarily.
- Multipage/GIF/Video files: Processing these files incurs charges per second or per frame, and not only once as for images.
-
Auto formatting: Using the auto format feature (
f_autoin delivery URLs) may generate up to four derived assets per transformation (for example, the original format, WebP, animated WebP, and WDP). - Responsive design: Using responsive features such as automatic width and DPR may generate a large number of derived assets for a single transformation to support different device displays. You can tune this behavior by overriding default values.
Also note that Cloudinary usage quotas, such as transformations and bandwidth, are calculated using a rolling 30-day window. Quotas don't reset at the beginning of each month, but update continuously based on usage during the previous 30 days.
If you have any questions, feel free to contact support.
✔️ Feedback sent!
Error
Unfortunately there's been an error sending your feedback.