Intégration Cloudinary n8nAutomatiser Cloudinary avec n8n.

Envoie dans la médiathèque un fichier binaire produit par une étape précédente et renvoie le média stocké.

• File : le fichier à envoyer, requis, généralement la sortie du nœud qui vient de le récupérer.
• Resource Type : image, video ou raw, pour qu'un PDF ne soit pas traité comme une photo.
• Additional Fields : Folder, Public ID, Tags, Structured Metadata en JSON et Upload Preset si le compte en définit déjà un.

Cloudinary va chercher lui-même le fichier à l'adresse indiquée : rien ne transite par le workflow.

• URL : l'adresse de l'image à importer, requise, souvent {{ $json.url }} depuis la ligne traitée.
• Resource Type : video quand le lien pointe vers un clip, sinon image.
• Additional Fields : Public ID pour garder un nom stable, Folder pour ranger, Tags pour regrouper.

Enchaîne plusieurs étapes de transformation dans l'ordre et renvoie une seule URL de diffusion, plus une chaîne de transformation réutilisable.

• Public ID : requis, le chemin du média sans l'extension, du type folder/sample.
• Steps : chaque étape choisit une Action, Resize, Crop, Convert Format, Optimize, Trim ou Raw Component, appliquées dans l'ordre affiché.
• Resource Type : image ou video, ce qui détermine le chemin de l'URL.

Pour une équipe qui connaît déjà la syntaxe Cloudinary, l'URL se construit à partir d'une chaîne brute reprise telle quelle.

• Public ID : requis, chemin de dossier inclus, extension exclue.
• Transformation : requise, les composants séparés par une barre oblique et les qualificateurs par des virgules, par exemple c_fill,g_auto,w_400,h_300/f_auto/q_auto.
• Format : extension de diffusion facultative, sans le point.

Renvoie une URL qui sert la même image dans un autre format de fichier.

• Public ID : requis, identifie l'image à convertir.
• Target Format : avif, webp, jpg, png ou gif.
• Continue From Transformation : reprends le champ transformation d'une étape Transform précédente pour cumuler les deux dans une seule URL.

Découpe une image à des dimensions fixes ou selon un rapport, et rend l'URL et la chaîne de transformation.

• Crop By : Dimensions pour une Width et une Height exactes, ou Aspect Ratio pour une valeur comme 16:9.
• Focus : Auto détecte la zone importante, Face centre sur un visage, Center garde le milieu.
• Generative Fill : étend l'image au lieu de la couper, consomme des crédits de transformation supplémentaires et peut se calculer en différé au premier appel.

Format automatique et qualité automatique en une étape : c'est le gain de poids le moins cher sur une image diffusée.

• Public ID : requis, le média à alléger.
• Quality : Auto est le réglage recommandé, Best garde du détail, Eco et Low échangent de la qualité contre du poids.
• Continue From Transformation : à chaîner après un Resize ou un Crop, qui n'optimisent rien d'eux-mêmes.

Produit une URL à la largeur et à la hauteur demandées, avec le choix de la façon dont l'image occupe le cadre.

• Width et Height : laisse l'une à 0 pour dimensionner par l'autre seulement.
• Fit : Limit n'agrandit jamais, Fit peut agrandir, les modes Pad gardent toute l'image et remplissent le reste.
• Pad Background : noir par défaut, ou Auto, Blurred, ou une Background Color donnée en nom ou en hexadécimal.

Même logique de cadrage que pour l'image, appliquée à un clip pour l'adapter à un autre emplacement.

• Public ID : requis, le chemin de la vidéo sans extension.
• Crop By : Dimensions avec Width et Height, ou Aspect Ratio avec une valeur comme 9:16.
• Focus : Auto, Face ou Center décide de ce qui reste dans le cadre une fois les bords coupés.

Laisse Cloudinary choisir le format, le codec et la qualité selon le navigateur qui demande le fichier.

• Quality : Auto pour l'équilibre par défaut, Good pour un entre-deux, Eco ou Low quand la bande passante compte plus que le détail.
• Continue From Transformation : branche le champ transformation d'une étape Trim ou Resize pour cumuler les deux.

Met un clip à la taille visée et renvoie l'URL qui le diffuse.

• Width et Height : 0 d'un côté dimensionne par l'autre.
• Fit : Scale force les dimensions exactes et peut déformer si les deux sont renseignées, les modes Pad ajoutent des bandes.
• Pad Background : Auto prélève une couleur du clip, Blurred utilise une copie floutée, Solid Color prend la valeur choisie.

Extrait une image fixe d'une vidéo et la diffuse comme une image.

• Frame : Auto laisse Cloudinary choisir un moment représentatif, Specific Time utilise le Timestamp en secondes.
• Image Format : jpg, png, webp ou gif pour l'image générée.
• Public ID : requis, le clip source.

Raccourcit un clip par l'URL de diffusion, le fichier stocké restant intact.

• Start Offset et End Offset : des temps en secondes, et toute combinaison de début, fin et durée est acceptée.
• Duration : la durée du clip en secondes quand tu préfères dire combien de temps plutôt qu'où t'arrêter.
• Continue From Transformation : conserve un recadrage ou un redimensionnement placé avant la coupe.

Retire un ou plusieurs médias de la médiathèque, par identifiant public.

• Public ID(s) : requis, une valeur seule, plusieurs séparées par des virgules, ou une expression qui renvoie un tableau.
• Type : type de stockage requis, Upload, Private, Authenticated ou Fetch.
• Delete Options : Keep Original ne supprime que les versions dérivées, Invalidate CDN purge les copies en cache, Transformations limite la suppression aux dérivés listés.

Lit la fiche complète d'un média pour que la suite du workflow puisse s'y adapter.

• Asset ID : requis, l'asset_id immuable, pas l'identifiant public.
• Options : Colors renvoie les couleurs dominantes, Faces les coordonnées des visages détectés, Image Metadata les valeurs IPTC, XMP et EXIF, Pages le nombre de pages des fichiers multipages.

Interroge la médiathèque avec une expression de recherche Cloudinary et renvoie les médias correspondants.

• Expression : par exemple folder:products/*, et une valeur vide correspond à tout.
• Resource Types : Cloudinary ne cherche que les images par défaut, coche Video ou Raw pour élargir.
• Return All : activé, n8n enchaîne les pages de résultats ; désactivé, Max Results plafonne entre 1 et 500.
• With Field : ajoute Tags ou Context pour éviter une seconde requête plus loin.

Écrit des métadonnées structurées sur un média identifié par son asset ID.

• Asset ID : requis, l'identifiant immuable renvoyé par la médiathèque.
• Structured Metadata : JSON requis, de la forme {"field1": "value1"}, aligné sur les champs définis par le compte.
• Invalidate CDN : purge les copies en cache une fois les valeurs modifiées.

Définit ou complète la liste des tags sur un ou plusieurs médias.

• Asset ID et Public ID(s) : les deux sont requis, car le point d'entrée d'ajout de tags fonctionne par identifiant public et n'accepte pas l'asset ID.
• Tags : requis, une liste de noms séparés par des virgules.
• Mode : Set remplace toute la liste, Append conserve l'existant.
• Type : doit correspondre au média, les identifiants publics étant liés au couple resource type et type.

Construit le code d'intégration et la configuration du Cloudinary Video Player, renvoyés sous forme d'URL d'embarquement et de configuration de lecteur.

• Public ID : requis, le clip à lire.
• Source Types : ordre de repli, sachant que HLS et MPEG-DASH ne se combinent pas avec une Transformation qui fige un format.
• Poster : l'image affichée avant la lecture, idéalement l'URL d'une étape Video: Thumbnail.
• Playback : Muted, Loop, Autoplay Mode, et Generate Captions pour des sous-titres générés dans la langue parlée.

Liste les champs de métadonnées structurées définis sur le compte, sans aucun paramètre à remplir.

Renvoie les tags utilisés pour un type de média, de quoi vérifier une étiquette avant de l'appliquer.

• Resource Type : requis, image, video ou raw.
• Prefix : ne garde que les tags commençant par les caractères indiqués.
• Max Results : plafonne la liste entre 1 et 500.

La voie historique vers le même résultat, conservée pour les workflows antérieurs à la ressource Asset. Elle est dépréciée, et tout nouveau chantier passe par la ressource Asset.

• Public ID : requis, le média à mettre à jour, cette ressource travaillant par identifiant public.
• Type : type de stockage requis, Upload, Private, Authenticated ou Fetch.
• Structured Metadata : JSON requis, clés de champs et valeurs.

L'étiquetage par la ressource dépréciée à identifiant public, utile seulement tant qu'un workflow existant n'a pas migré.

• Public ID et Type : requis tous les deux, ils localisent le média dans l'ancien mode d'adressage.
• Public ID(s) : requis, les médias à étiqueter, valeur unique ou séparée par des virgules.
• Tags : requis, des noms séparés par des virgules, appliqués selon Mode, Set ou Append.