Cloudinary icon

Cloudinary

Upload images and videos, build optimized transformation and delivery URLs, generate video players, and manage, search, tag, and edit metadata in your Cloudinary media library

Actions23

Transform → Video: Optimize

AI-generated

Overview

This node operation optimizes videos stored in Cloudinary by generating optimized transformation and delivery URLs. It allows users to specify the public ID of the video asset, choose the delivery type (e.g., upload, fetch, social media sources), and set the video quality level automatically or manually. Users can also chain transformations by continuing from a previous transformation and add additional options such as versioning to bust CDN caches. This operation is beneficial for scenarios where video content needs to be efficiently delivered with optimized quality and size, such as streaming platforms, marketing campaigns, or content delivery networks.

Use Case Examples

  1. Optimizing a video for web delivery by specifying the public ID and letting Cloudinary automatically choose the best quality/size trade-off.
  2. Chaining multiple video transformations by continuing from a previous transformation's output to create a compound delivery URL.
  3. Setting a specific video quality level like 'Auto - Best' for higher quality video streaming.

Properties

Name Meaning
Public ID The public ID of the video asset in Cloudinary, including any folder path but without the file extension. This identifies the video to be optimized.
Type The Cloudinary delivery type for the video asset. Usually 'Upload' for public assets. Other types include social media sources and private/authenticated assets which require signed URLs not generated by this node.
Continue From Transformation Optional transformation string to build on, prepended before this operation's own transformation to compound into one delivery URL. Useful for chaining transformations across nodes.
Quality Automatic quality level for the video. Cloudinary auto-selects format and codec for the requesting browser. Options range from 'Auto (Recommended)' to 'Auto - Low' for different quality and file size trade-offs.
Additional Options Optional additional transformation options such as versioning to bust CDN caches.

Output

JSON

  • transformation - The generated transformation string for the optimized video delivery URL.
  • url - The full URL to the optimized video asset with applied transformations.

Dependencies

  • Cloudinary API credentials including cloud name, API key, and API secret

Troubleshooting

  • Ensure the public ID is correct and includes the folder path if applicable, but without the file extension.
  • Use 'Upload' as the delivery type unless you specifically need another type, as private and authenticated assets require signed URLs which this node does not generate.
  • If the video does not load, check if the delivery type requires a signed URL and consider that this node does not support generating signed URLs yet.
  • Verify that the Cloudinary API credentials are correctly configured and have the necessary permissions.

Links

Discussion