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

Upload → Upload From URL

AI-generated

Overview

This node uploads media assets (images, videos, or raw files) to Cloudinary from a specified URL. It is useful for automating the process of importing media hosted on external URLs directly into a Cloudinary media library. For example, users can upload product images or promotional videos from web URLs into their Cloudinary account for further management and delivery.

Use Case Examples

  1. Uploading an image from a URL to Cloudinary for use in a website gallery.
  2. Uploading a video from a URL to Cloudinary to embed in marketing emails.
  3. Uploading raw files from URLs for storage and later processing.

Properties

Name Meaning
URL The URL of the image or media file to upload. This is required to specify the source location of the asset.
Resource Type The type of asset to upload, which can be an image, video, or raw file. This determines how Cloudinary processes and stores the asset.
Additional Fields Optional fields to customize the upload, including folder name, public ID, structured metadata, tags, and upload preset.

Output

JSON

  • public_id - The public identifier assigned to the uploaded asset in Cloudinary.
  • version - The version number of the uploaded asset.
  • signature - Signature string for the uploaded asset.
  • width - Width of the uploaded image or video.
  • height - Height of the uploaded image or video.
  • format - File format of the uploaded asset.
  • resource_type - Type of the uploaded resource (image, video, or raw).
  • created_at - Timestamp when the asset was created in Cloudinary.
  • tags - Tags assigned to the uploaded asset.
  • bytes - Size of the uploaded asset in bytes.
  • type - Type of the uploaded asset, e.g., upload.
  • etag - ETag of the uploaded asset.
  • url - URL to access the uploaded asset.
  • secure_url - Secure HTTPS URL to access the uploaded asset.

Dependencies

  • Cloudinary API credentials (cloud name, API key, API secret) are required for authentication.

Troubleshooting

  • Common issues include invalid or inaccessible URLs, incorrect Cloudinary credentials, or unsupported resource types. The node throws errors if the operation is unsupported or if upload fails.
  • Error messages related to authentication failures indicate incorrect or missing API credentials. Verify the credentials in the node settings.
  • Errors about unsupported operations mean the resource or operation name is incorrect or not implemented. Check the node configuration.

Links

Discussion