- Get Started
- Image & Video APIs overview
- AI Power Start
- Prompt Library
- SDK Quick Starts
- Developer Kickstart
- AI agents
- Try it!
- VS Code Extension
- 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
- Add images to Sanity 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
- 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
- Crop images in PHP
- 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
- Named transformations
- Transformation rollout
- Image format support
- Delivery types and flags
- Transformation types
- Resizing and cropping
- Placing layers on images
- Effects and enhancements
- Background removal
- Generative AI transformations
- Face-detection based transformations
- Advanced image transformations
- Image transformation recipes
- Image optimization and delivery
- Programmatic image creation
- Product Gallery widget
- Media Editor widget
- Image add-ons
- Troubleshooting and tips
- Troubleshooting image transformation and delivery errors
- Menu Title
- 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
- Cloudinary Video
- Product overview
- Cloudinary Video Player
- Video Player features
- When to use the video player
- 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 transformations overview
- Named transformations
- Transformation rollout
- Video Canvas
- Transcoding and formats
- Delivery types and flags
- Transformation types
- Resizing and cropping
- Trimming and concatenating
- Placing layers on videos
- Effects and enhancements
- Audio transformations
- Advanced video transformations
- Video transformation recipes
- Video and audio optimization
- Video transcription
- AI Video Analysis
- AI Video Analysis API reference
- 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?
- Asset ID vs public ID
- 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
- Account settings
- Product environment settings
- User provisioning
- Billing and plans
- Roles and Permissions
- Usage data
- How are transformations counted?
- Troubleshooting and tips
- Cancel or delete Cloudinary account
- Sign up or add user with existing email
- Credit card payments
- Recover disabled account
- Can't downgrade my plan
- Migrate Media Optimizer account
- Why did my usage spike?
- Rotate API keys in the Console
- Successfully go live with Cloudinary
- Bot traffic and access control
- China Delivery requirements
- 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
- Cloudinary Image Generation
- Google AI Video Moderation
- Google AI Video Transcription
- Google Auto Tagging
- Google Automatic Video Tagging
- Google Translation
- Image to Video
- Image to Video API reference
- 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
Create animated images
Get Started with Cloudinary
Paste one prompt into your AI coding assistant and it sets up Cloudinary for you: installs the SDK, configures skills and MCP servers, and validates your setup.
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:
View the Skills repo on GitHub | Learn about Cloudinary Skills
Last updated: Nov-12-2025
You can create a single animated image (GIF, PNG or WebP) or video (MP4 or WebM) from multiple image assets, where each asset is used as a single frame of the resulting animated image or video.
Animated images can be created from a maximum of 500 frames (individual images), except in the following cases where the maximum is 100 frames:
- If the processing is done in a synchronous mode (i.e., without the
asyncparameter set to true). - If there is an underlay or overlay added to the image (
l_oru_). - If any transformation parameters are added that are not on the following list:
background,flags,crop,width,height,x,y,gravity,quality,angle,page, anddpr. - If the
angleparameter is added with a value that is anything butexiforauto. - If the
cropparameter is added with a value that is anything butscale,limit,fit,fill,thumborcrop.
If the limit is exceeded, only the first 500 (or 100) images will be included.
Step 1: Upload and tag the images
Upload all the images to be included in the animated image or video. Make sure that you include:
- An appropriate public ID when uploading each of the files; when they are merged into a single animated image or video, they are sorted alphabetically by their public IDs.
- An identical tag for all images. The tag must be unique to these images only; the animated image creation process finds all images with the same tag and merges them into a single file.
Step 2: Create the animated image
Use the multi method of the upload API to create the animated image. If the images to be merged are not all the same size, you can add transformation parameters to the URL to crop them accordingly (using one of the crop modes plus width or height, etc). For example, to create an animated GIF from all images with the tag arrow_animation:
Step 3: Deliver the animated image
To deliver the animated image, use the Cloudinary image delivery URL with type set to multi. For example, to deliver an animated GIF created from all images with the tag arrow_animation:

Example script
The following example showcases a method to create a very simple animated GIF of revolving text consisting of 20 individual frames. A script is executed to upload the individual images to Cloudinary, where each individual image (frame) is constructed from:
- A previously uploaded blank image used as a base image.
- A text string overlaid over the base image.
Each frame is a combination of the base image together with an overlay of a slightly modified version of the text string. The text is modified for each frame with the distort effect parameter to change its perspective.
After the script is run and the images are uploaded, the following URL delivers the animated GIF:

✔️ Feedback sent!
Error
Unfortunately there's been an error sending your feedback.