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

Widget → Video Player

AI-generated

Overview

This node operation generates a Cloudinary video player widget URL and configuration based on the provided video asset's public ID and various customizable player options. It is useful for embedding Cloudinary-hosted videos with tailored playback, appearance, and AI-generated content features in web applications or workflows. For example, users can specify video source types, autoplay behavior, player dimensions, theme colors, and enable AI captions or chapters.

Use Case Examples

  1. Embedding a responsive Cloudinary video player with autoplay and custom controls on a website.
  2. Generating a video player URL with AI-generated captions and chapters for accessibility.
  3. Creating a video player with specific aspect ratio and color theme for brand consistency.

Properties

Name Meaning
Public ID The public ID of the video asset including any folder path but without the file extension. This identifies the video to be played.
Type The Cloudinary delivery type for the video asset, such as 'upload' for public assets or other types like 'fetch' or social media sources. Determines the URL path segment for delivery.
Transformation Cloudinary transformation string applied to the played video stream, affecting the iframe embed URL and player configuration. Supports video-capable transformations like resize, crop, blur, fade, etc.
Poster URL of the still image shown before playback starts. If empty, a frame from the video is used.
Source Types The video formats the player can request in fallback order, such as HLS, MP4, MPEG-DASH, Ogg, WebM, or auto. Determines the formats the player tries to use based on browser support.
Playback Options controlling how and when the video plays, including autoplay mode, muted state, loop, inline playback, controls visibility, and big play button display.
Size & Layout Player dimensions and shape settings, including fluid resizing, width, height, aspect ratio, and crop mode.
AI-Generated Content Options to enable AI-generated captions, title, description, and chapter markers from the video audio, including subtitle languages and UI controls.
Appearance Player theme, colors, and font settings including skin, base color, accent color, text color, and font face.
Player Features Optional interface controls and capabilities such as floating mini-player, HDR delivery, picture-in-picture toggle, and seek thumbnails.
Autoplay Mode When the video should start playing automatically (never, always, on scroll) for version 1 compatibility.
Muted Whether the player starts muted for version 1 compatibility.
Loop Whether the video restarts from the beginning when it ends for version 1 compatibility.
Fluid Whether the player resizes responsively to fill its container for version 1 compatibility.
Width Player width in pixels, default 640 for version 1 compatibility.
Height Player height in pixels, default 360 for version 1 compatibility.
Aspect Ratio Player aspect ratio for version 1 compatibility.
Crop Mode How the player resizes the video to the chosen aspect ratio for version 1 compatibility.
Skin Player theme for version 1 compatibility.
Base Color Player base (background) color as hex for version 1 compatibility.
Accent Color Player accent (highlight) color as hex for version 1 compatibility.
Text Color Player text color as hex for version 1 compatibility.
Font Face Font applied to player text elements for version 1 compatibility.
Advanced Player Options Additional player options for version 1 compatibility including big play button, chapters button, floating mini-player, HDR, picture-in-picture toggle, inline playback, seek thumbnails, and controls visibility.

Output

JSON

  • json
    • iframeUrl - The URL of the generated Cloudinary video player iframe embed.
    • playerConfig - The configuration object for the Cloudinary video player, including playback, appearance, and feature settings.

Dependencies

  • Cloudinary API credentials (cloud name, API key, API secret)

Troubleshooting

  • Ensure the Public ID is correct and the video asset exists in the Cloudinary account.
  • Use 'upload' type for public assets unless signed URLs are supported and required.
  • If using private or authenticated assets, note that signed URLs are not generated by this node, so playback URLs may fail.
  • Check that transformations applied are compatible with the selected source types (e.g., avoid format pinning with adaptive streaming).
  • Verify that AI-generated content options require video audio with dialogue and may need additional account add-ons for subtitle translations.

Links

Discussion