Cloudinary CLI: subir y transformar assets

cloudinary-cli es el CLI oficial de Cloudinary (gestión de imágenes y video en la nube). Se invoca como cld y cubre lo básico del día a día — subir assets, buscarlos y generar URLs con transformaciones — sin entrar a la consola web.

Instalación

Igual en Windows, macOS y Linux — vía pip:

pip install cloudinary-cli

Para entornos aislados también hay pipx install cloudinary-cli o uv tool install cloudinary-cli.

Configurar credenciales

El patrón típico de Cloudinary es una única variable de entorno con todo el string de conexión, CLOUDINARY_URL:

# macOS / Linux
export CLOUDINARY_URL=cloudinary://<api_key>:<api_secret>@<cloud_name>

# Windows (cmd)
set CLOUDINARY_URL=cloudinary://<api_key>:<api_secret>@<cloud_name>

# Windows (PowerShell)
$env:CLOUDINARY_URL="cloudinary://<api_key>:<api_secret>@<cloud_name>"

Las credenciales están en Settings → API Keys del Cloudinary Console. También existe cld login, que autentica vía navegador (OAuth) sin tener que manejar el string a mano.

Confirmar que quedó bien configurado:

cld config

Comandos esenciales

Comando	Qué hace
cld uploader upload <archivo>	Sube un archivo (imagen, video, etc.) a Cloudinary
cld upload_dir <carpeta>	Sube una carpeta completa, manteniendo su estructura
cld search "<expresión>"	Busca recursos con sintaxis tipo Lucene
cld url <public_id>	Genera la URL de un recurso, con transformaciones opcionales
cld admin	Operaciones de la Admin API (listar, borrar recursos, etc.)

cld uploader upload ./foto.jpg
cld url foto --transformation w_400,h_400,c_fill

Consideraciones

• El CLI cubre bien las operaciones de subida, búsqueda y generación de URLs, pero para transformaciones complejas o configuración fina conviene revisar la documentación de transformaciones — cld url acepta la misma sintaxis de parámetros que la API.
• CLOUDINARY_URL queda en el entorno de la shell — para no dejarlo pisado en el historial, conviene setearlo desde un .env cargado por la propia terminal en vez de escribirlo a mano en cada sesión.
• cld login evita copiar la cadena de conexión manualmente y resulta especialmente cómodo si administras más de una cuenta.