Image & Video APIs

Cloudinary Image & Video release notes: NEXT VERSION

Last updated: TBD

Cloudinary Image

New Astro Sample Project

There's a new Photo Album sample project available, which demonstrates how to use the community-developed Astro SDK for uploading files to Cloudinary, and using transformations to optimize and customize their delivery and display.

Astro Photo Album sample project

Learn about Astro Cloudinary

Cloudinary Video

Auto video details generation

The upload and explicit methods of the Upload API now include a new parameter, auto_video_details, which generates comprehensive AI-powered metadata for your videos, including titles, descriptions, and automatic tags. This feature works on videos with audio that includes dialogue and provides richer contextual information to help organize and discover your video content.

When you upload videos with auto_video_details: true or by enabling the option in your upload preset, the system automatically:

  • Generates meaningful titles and descriptions based on video content analysis
  • Automatically adds relevant tags to help categorize and search your videos
  • Stores metadata as context values that the Cloudinary Video Player 3.1.0+ can use or that you can access via the Admin API

The Video Player can also generate titles and descriptions on demand when you set title: true and/or description: true in your player configuration, provided you've enabled Auto video details in your product environment's unsigned actions settings (Settings > Security). Note that player-based generation only creates titles and descriptions; automatic tag generation is only available through the Upload API's auto_video_details parameter.

Learn more

Video Player download functionality and AI generation improvements

The Cloudinary Video Player now includes a download button option and enhanced AI content generation capabilities:

  • Download button: Set download: true in your player configuration to display a download button in the video controls. Videos (including adaptive streaming formats) download as MP4 files, and audio files download as MP3 files. A loading spinner appears while content is being transcoded for download.

  • AI-powered content generation: The player can now automatically generate titles, descriptions, transcripts, and chapters on demand when they're missing. This includes support for transcript translation using the Google Translate add-on when you request multiple languages.

Learn more | API Reference

Asset and account management

CLI clone command

The clone command in the Cloudinary CLI now supports restricted assets.

If you're cloning restricted assets, a private download URL is generated which may incur additional bandwidth costs. To avoid these additional costs, you can configure an auth_key in your configuration:

CLOUDINARY_URL="cloudinary://<api_key>:<api_secret>@<cloud_name>?auth_token[duration]=<duration>&auth_token[key]=<key>"

The duration set in this configuration is for token-based access and ignored by the clone command. When cloning restricted assets with an auth_key configured, URLs expire after 3600 seconds by default. You can change this with the -ue option, but we advise against setting it to less than 3600 seconds. For information on obtaining an encryption key, see Token-based access (premium feature).

Learn more

Manage derived assets in the Media Library

The new Derived Assets tab on the Manage page now lets you quickly delete, download, open, or edit their transformations in the Transformation Builder.

Derived Assets tab

Learn more

Documentation

Captions, subtitles and chapters in all videos

All videos in the docs are now displayed using the Cloudinary Video Player with captions, subtitles in several languages, and chapters.

Each of these features were added using Cloudinary's AI-based capabilities.

Learn more:

Announcements

Remote MCP servers now available with OAuth authentication

Cloudinary's Model Context Protocol (MCP) servers are now available as remote, cloud-hosted servers with OAuth authentication support in addition to the previously published local-only deployment model.

Key benefits of remote MCP servers:

  • Easy setup: No local installation required. Simply authenticate via OAuth to connect to your Cloudinary account.
  • Universal accessibility: Works with web-based AI agents, IDEs, and any MCP-compatible client with internet access.

Remote servers use Server-Sent Events (SSE) for communication and you can access them from anywhere with an internet connection, making them ideal for teams and web-based development environments.

Learn more about MCP server deployment options

create_collage and sprite endpoint deprecation

The Sprite feature and the Image Collage feature using the create_collage method will be deprecated as of September 16, 2025, and will no longer function after that date. Be sure to remove these features from any production code.

You can continue creating collages using overlays.

✔️ Feedback sent!

Rate this page: