Integración Cloudinary n8nAutomatiza Cloudinary con n8n.

Envía a la mediateca un archivo binario producido por un paso anterior y devuelve el recurso ya guardado.

• File: el archivo a subir, obligatorio, normalmente la salida del nodo que acaba de obtenerlo.
• Resource Type: image, video o raw, para que un PDF no se trate como una foto.
• Additional Fields: Folder, Public ID, Tags, Structured Metadata en JSON y Upload Preset si la cuenta ya define alguno.

Cloudinary recoge el archivo por su cuenta desde la dirección que le pasas, sin que nada baje al flujo.

• URL: la dirección de la imagen a importar, obligatoria, a menudo {{ $json.url }} desde la fila tratada.
• Resource Type: video cuando el enlace apunta a un clip, si no image.
• Additional Fields: Public ID para mantener un nombre estable, Folder para ordenar, Tags para agrupar.

Encadena varios pasos de transformación en orden y devuelve una sola URL de entrega, más una cadena de transformación reutilizable.

• Public ID: obligatorio, la ruta del archivo sin la extensión, del tipo folder/sample.
• Steps: cada paso elige una Action, Resize, Crop, Convert Format, Optimize, Trim o Raw Component, aplicadas en el orden mostrado.
• Resource Type: image o video, lo que determina la ruta de la URL.

Para un equipo que ya domina la sintaxis de Cloudinary, la URL se construye a partir de una cadena en bruto usada tal cual.

• Public ID: obligatorio, con la ruta de carpeta y sin extensión.
• Transformation: obligatoria, con los componentes separados por barra y los calificadores por comas, por ejemplo c_fill,g_auto,w_400,h_300/f_auto/q_auto.
• Format: extensión de entrega opcional, sin el punto inicial.

Devuelve una URL que sirve la misma imagen en otro formato de archivo.

• Public ID: obligatorio, identifica la imagen a convertir.
• Target Format: avif, webp, jpg, png o gif.
• Continue From Transformation: reutiliza el campo transformation de un paso Transform anterior para acumular ambos en una sola URL.

Recorta una imagen a medidas fijas o a una proporción, y entrega la URL junto con la cadena de transformación.

• Crop By: Dimensions para un Width y un Height exactos, o Aspect Ratio para un valor como 16:9.
• Focus: Auto detecta la zona importante, Face centra en un rostro, Center mantiene el medio.
• Generative Fill: extiende la imagen en vez de cortarla, consume créditos de transformación adicionales y puede generarse de forma diferida en la primera petición.

Formato automático y calidad automática en un paso, el ahorro de peso más barato en cualquier imagen que entregues.

• Public ID: obligatorio, el archivo a optimizar.
• Quality: Auto es el ajuste recomendado, Best conserva detalle, Eco y Low cambian calidad por tamaño.
• Continue From Transformation: encadénalo después de un Resize o un Crop, porque ninguno de los dos optimiza por su cuenta.

Genera una URL con el ancho y el alto pedidos, con opción de decidir cómo ocupa la imagen ese marco.

• Width y Height: deja uno en 0 para dimensionar solo por el otro.
• Fit: Limit nunca amplía, Fit sí puede, los modos Pad conservan toda la imagen y rellenan el resto.
• Pad Background: negro por defecto, o Auto, Blurred, o un Background Color indicado por nombre o en hexadecimal.

La misma lógica de encuadre que en imagen, aplicada a un clip para adaptarlo a otra ubicación.

• Public ID: obligatorio, la ruta del vídeo sin extensión.
• Crop By: Dimensions con Width y Height, o Aspect Ratio con un valor como 9:16.
• Focus: Auto, Face o Center decide qué queda dentro del cuadro cuando se cortan los bordes.

Deja que Cloudinary elija el formato, el códec y la calidad según el navegador que pide el archivo.

• Quality: Auto para el equilibrio por defecto, Good para un término medio, Eco o Low cuando el ancho de banda pesa más que el detalle.
• Continue From Transformation: conecta el campo transformation de un paso Trim o Resize para acumular ambos.

Ajusta un clip al tamaño buscado y devuelve la URL que lo entrega.

• Width y Height: un 0 en un lado dimensiona por el otro.
• Fit: Scale fuerza las medidas exactas y puede deformar si se rellenan las dos, los modos Pad añaden bandas.
• Pad Background: Auto toma un color del clip, Blurred usa una copia desenfocada, Solid Color aplica el valor elegido.

Extrae un fotograma fijo de un vídeo y lo entrega como imagen.

• Frame: Auto deja que Cloudinary elija un momento representativo, Specific Time usa el Timestamp en segundos.
• Image Format: jpg, png, webp o gif para la imagen generada.
• Public ID: obligatorio, el clip de origen.

Acorta un clip desde la URL de entrega, dejando intacto el archivo guardado.

• Start Offset y End Offset: tiempos en segundos, y se acepta cualquier combinación de inicio, fin y duración.
• Duration: la duración del clip en segundos cuando prefieres decir cuánto dura en vez de dónde acaba.
• Continue From Transformation: conserva un recorte o un cambio de tamaño colocado antes del corte.

Retira uno o varios archivos de la mediateca, por identificador público.

• Public ID(s): obligatorio, un valor suelto, varios separados por comas, o una expresión que devuelva un array.
• Type: tipo de almacenamiento obligatorio, Upload, Private, Authenticated o Fetch.
• Delete Options: Keep Original borra solo las versiones derivadas, Invalidate CDN limpia las copias en caché, Transformations limita el borrado a los derivados indicados.

Lee la ficha completa de un archivo para que el resto del flujo pueda decidir a partir de ella.

• Asset ID: obligatorio, el asset_id inmutable, no el identificador público.
• Options: Colors devuelve los colores predominantes, Faces las coordenadas de los rostros detectados, Image Metadata los valores IPTC, XMP y EXIF, Pages el número de páginas de los archivos multipágina.

Consulta la mediateca con una expresión de búsqueda de Cloudinary y devuelve los archivos que coinciden.

• Expression: por ejemplo folder:products/*, y un valor vacío coincide con todo.
• Resource Types: Cloudinary busca solo imágenes por defecto, marca Video o Raw para ampliar.
• Return All: activado, n8n recorre todas las páginas de resultados; desactivado, Max Results pone un tope entre 1 y 500.
• With Field: añade Tags o Context para evitar una segunda consulta más adelante.

Escribe metadatos estructurados en un archivo identificado por su asset ID.

• Asset ID: obligatorio, el identificador inmutable que devuelve la mediateca.
• Structured Metadata: JSON obligatorio, con la forma {"field1": "value1"}, alineado con los campos que define la cuenta.
• Invalidate CDN: limpia las copias en caché cuando cambian los valores.

Fija o amplía la lista de etiquetas en uno o varios archivos.

• Asset ID y Public ID(s): los dos son obligatorios, porque el endpoint de añadir etiquetas funciona por identificador público y no acepta el asset ID.
• Tags: obligatorio, una lista de nombres separados por comas.
• Mode: Set sustituye toda la lista, Append conserva lo que ya había.
• Type: tiene que coincidir con el archivo, ya que los identificadores públicos dependen del par resource type y type.

Construye el código de inserción y la configuración del Cloudinary Video Player, devueltos como URL de inserción y configuración de reproductor.

• Public ID: obligatorio, el clip que se reproduce.
• Source Types: orden de respaldo, teniendo en cuenta que HLS y MPEG-DASH no se combinan con una Transformation que fija un formato.
• Poster: la imagen que se ve antes de la reproducción, idealmente la URL de un paso Video: Thumbnail.
• Playback: Muted, Loop, Autoplay Mode y Generate Captions para subtítulos generados en el idioma hablado.

Lista los campos de metadatos estructurados definidos en la cuenta, sin ningún parámetro que rellenar.

Devuelve las etiquetas en uso para un tipo de archivo, que es como se comprueba una etiqueta antes de aplicarla.

• Resource Type: obligatorio, image, video o raw.
• Prefix: conserva solo las etiquetas que empiezan por los caracteres indicados.
• Max Results: pone un tope a la lista entre 1 y 500.

La vía heredada hacia el mismo resultado, conservada para flujos anteriores al recurso Asset. Está obsoleta, y todo trabajo nuevo pasa por el recurso Asset.

• Public ID: obligatorio, el archivo a actualizar, porque este recurso trabaja por identificador público.
• Type: tipo de almacenamiento obligatorio, Upload, Private, Authenticated o Fetch.
• Structured Metadata: JSON obligatorio con claves de campo y valores.

El etiquetado a través del recurso obsoleto por identificador público, útil solo mientras un flujo existente no se haya migrado.

• Public ID y Type: obligatorios los dos, sitúan el archivo en el esquema de direccionamiento antiguo.
• Public ID(s): obligatorio, los archivos a etiquetar, valor único o separados por comas.
• Tags: obligatorio, nombres separados por comas, aplicados según Mode, Set o Append.