Migrar desde Cloudinary, Filestack, Mux o Uploadcare

Kevin van Zonneveld

Cofundador · Ámsterdam, Países Bajos · Mostrar bio

Reúne las subidas, el redimensionamiento de imágenes, la codificación de video y las vistas previas de documentos en un solo pipeline versionado, con los archivos en un almacenamiento que tú controlas. Nuestras guías de migración muestran cómo adaptar los flujos de trabajo de Cloudinary, Filestack, Mux y Uploadcare a Transloadit, trasladar tus archivos existentes y cambiar el tráfico gradualmente.

Cada guía explica cómo adaptar los flujos de subida y procesamiento, proporciona Templates de ejemplo, explica cómo importar fuentes existentes e incluye una lista de verificación para la transición.

• Migra desde Cloudinary: ajustes preestablecidos de subida, transformaciones fijas y anticipadas, inventario de activos y sustitución de referencias de entrega
• Migra desde Filestack: callbacks del selector de archivos, enrutamiento por MIME para imágenes y PDF, vistas previas estáticas y conciliación del estado de las exportaciones parciales antes de reintentarlas
• Migra desde Mux: subidas directas, HLS generado de antemano o bajo demanda, imágenes de póster, originales conservados o archivos maestros temporales y cambios en los IDs de reproducción
• Migra desde Uploadcare: callbacks del componente de subida, recetas de operaciones de CDN, variantes de imagen optimizadas y registros separados de metadatos y grupos de archivos

Relaciona primero los conceptos

En Transloadit, un Robot ejecuta cada Step de procesamiento, y los Steps juntos forman tus Assembly Instructions. Puedes guardar esas instrucciones como un Template y ejecutarlas como una Assembly para cada subida o importación. Así encajan los componentes de subida y procesamiento:

Los Templates son JSON, por lo que puedes mantener las reglas de procesamiento en el control de versiones junto al código de tu aplicación, como recomiendan las guías. Revisa los cambios junto con el código de tu aplicación y reutiliza las reglas de procesamiento para nuevas subidas e importaciones de archivos existentes.

Una transformación, cuatro proveedores

Para los tres proveedores de imágenes, aquí tienes una miniatura WebP cuadrada de 400×400 en la sintaxis de cada proveedor, junto con su equivalente en Transloadit. Para Mux, compara una solicitud de imagen de póster a los cinco segundos dentro de un recuadro de 640×360.

Estas tres operaciones de imagen escalan la imagen para cubrir el recuadro y recortan lo que sobresale tomando el centro como referencia. Eso es lo que hace resize_strategy: "fillcrop" en el Robot 🤖 /image/resize, y encontrarás ese mismo Step en el ejemplo de importación de imágenes existentes que aparece más abajo. Compara el aspecto y la calidad con tus propias imágenes; igualar la geometría del recorte no reproduce la selección automática de formato, calidad o punto focal.

Para los fotogramas de póster, configura offsets en segundos en el Robot 🤖 /video/thumbs. El modo de ajuste predeterminado de Mux conserva la relación de aspecto dentro del recuadro solicitado, así que combina width: 640 y height: 360 con resize_strategy: "fit". La estrategia predeterminada pad añadiría barras en su lugar. A partir de un video de prueba con una relación de aspecto de 4:3, ese Step nos dio una imagen de póster de 480×360.

Traslada también tus archivos existentes

Una migración no está terminada hasta que también se ha trasladado tu biblioteca existente. Las guías explican cómo inventariar las fuentes e importar URL autorizadas con el Robot 🤖 /http/import. Su parámetro url también acepta un array, por lo que puedes trasladar archivos en lotes de tamaño limitado. La guía de Mux muestra cómo sustituir el Step de entrada de su Template de video; las otras guías incluyen Templates para importar imágenes existentes. Aquí tienes un ejemplo ejecutable que importa dos imágenes públicas y crea la miniatura de la tabla anterior. Guárdalo como backfill.json:

{
  "imported": {
    "robot": "/http/import",
    "url": [
      "https://demos.transloadit.com/inputs/chameleon.jpg",
      "https://demos.transloadit.com/inputs/prinsengracht.jpg"
    ]
  },
  "thumb": {
    "use": "imported",
    "robot": "/image/resize",
    "width": 400,
    "height": 400,
    "resize_strategy": "fillcrop",
    "format": "webp",
    "result": true
  }
}

Ejecútalo en tu terminal con la CLI incluida en nuestro SDK de Node.js, probado aquí con @transloadit/node 5.1.0. Cuando la Assembly se completa, la CLI imprime una URL para cada miniatura. Las URL abreviadas que aparecen a continuación serán diferentes en tu ejecución:

$ export TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY
$ npx -y @transloadit/node assemblies create --steps backfill.json --print-urls
STEP   NAME                URL
thumb  chameleon.webp      https://pub-….r2.dev/…/….webp
thumb  prinsengracht.webp  https://pub-….r2.dev/…/….webp

Estas URL de resultados son temporales; los archivos normalmente se conservan durante 24 horas y están destinados a recuperarse a corto plazo. En producción, las guías añaden un Step de exportación, como el Robot 🤖 /s3/store, con tus propias credenciales. Configura notify_url en la solicitud firmada de la Assembly, verifica las firmas de las notificaciones y exige ASSEMBLY_COMPLETED. Antes de actualizar tu aplicación, lee los resultados de los Steps que los generan y comprueba is_temp_url: false para guardar URL de exportación permanentes. /http/import contabiliza el 10 % de los bytes importados como uso de procesamiento; el redimensionamiento, la extracción de metadatos y cualquier exportación añaden su propio uso, según nuestros precios de Robots.

Conserva las URL dinámicas con Smart CDN

Si tu front-end construye URL de transformación sobre la marcha, no tienes que trasladar todo al momento de la subida. Smart CDN ejecuta un Template en la primera solicitud de una URL y almacena el resultado en la caché del borde de la red. Ese Template debe usar Robots compatibles, terminar su rama de respuesta en /file/serve y recibir las llamadas mediante URL que firmas en tu back-end. /image/resize funciona allí, mientras que /video/encode y /video/adaptive no. Para video, la guía de Mux remite a /video/ondemand, que genera HLS a medida que los espectadores lo solicitan.

La guía de Cloudinary recomienda generar variantes canónicas de antemano para páginas con mucho tráfico y usar Smart CDN para bibliotecas con numerosos archivos de acceso poco frecuente. Nuestro artículo Sube una vez, transforma siempre EN (English) explica de principio a fin la configuración bajo demanda.

Lo que obtienes después del cambio

• Un solo pipeline para imágenes, video y documentos. Una sola Assembly puede importar archivos, redimensionar imágenes, codificar video, generar miniaturas de documentos y exportar los resultados. La guía de Filestack, por ejemplo, enruta imágenes y PDF mediante un solo Template.
• Una sola métrica de uso para todos los tipos de medios. Planifica el procesamiento de imágenes, video y documentos con una sola métrica basada en GB, en lugar de precios de video por minuto. La mayoría de los Robots de procesamiento contabilizan los bytes de entrada y salida, con sus propios descuentos y cargos mínimos. Puedes establecer límites de gasto mensuales. Consulta los precios.
• Subidas con código abierto. Uppy, nuestro componente de subida de archivos, y tus-js-client, que su plugin Tus usa para las subidas reanudables, son proyectos de código abierto con licencia MIT, por lo que puedes leer, crear una bifurcación y ampliar el código de tu front-end de subida.
• Tu almacenamiento, tus regiones. Exporta los resultados a tu propio bucket y elige el procesamiento en Estados Unidos, Europa o Asia-Pacífico para la residencia de datos, o usa nuestro endpoint global. Configura por separado las regiones de almacenamiento y entrega.

Para conocer más ampliamente las diferencias entre estas plataformas, consulta nuestra comparación de plataformas de procesamiento multimedia para startups.

Planifica los cambios en la aplicación

Las guías abarcan el procesamiento, las subidas, el almacenamiento y las notificaciones. Copiar los bytes de los archivos multimedia no migra los metadatos, los grupos, las versiones, los permisos, los catálogos DAM alojados ni las integraciones con CMS. Conserva esos registros y reconstruye el comportamiento que necesitas en tu aplicación. Para Mux, la integración del reproductor, la analítica, la transmisión en vivo, el DRM y el empaquetado de pistas multilingües requieren una planificación aparte; una Assembly no recrea un Asset de Mux ni un ID de reproducción. Prueba por separado las alternativas a los efectos específicos del proveedor y los flujos de trabajo de IA; después, compara archivos reales y reglas de acceso antes de cambiar el tráfico.

Los ejemplos de las guías exportan a tu propio bucket. Transloadit Storage, nuestro almacenamiento gestionado para originales y resultados, está en una fase de acceso preliminar privado. Si quieres probarlo, pídenos que lo habilitemos para tu Workspace. La importación de imágenes existentes de este artículo usa resultados temporales y no necesita configuración de almacenamiento.

Empieza con un flujo de trabajo

Elige tu proveedor en el índice de migración, inventaría un flujo de trabajo, configura su destino de exportación y prueba unos cuantos archivos propios. Conserva los IDs antiguos de los activos y la correspondencia de entrega para poder revertir el cambio mientras trasladas el tráfico gradualmente. Regístrate para obtener tus credenciales y, si quieres que revisemos tu correspondencia entre conceptos, contáctanos.