Procesamiento y creación de video # Importa, codifica y republica videos de Vimeo con seguridad Importa una variante existente de Vimeo, normalízala a un MP4 controlado y exporta un nuevo video privado de Vimeo para revisión o migración. Publicado el 1 de septiembre de 2026 ## Conclusiones clave * Define si el trabajo es una migración de cuenta, una republicación controlada o un experimento derivado antes de copiar cualquier cosa. * Importa una página acotada de Vimeo y selecciona la variante fuente de forma deliberada. * Crea un derivado MP4 conocido en lugar de asumir que la variante importada cumple con la nueva política de entrega. Un pipeline de Vimeo a Vimeo es útil durante la consolidación de cuentas, la republicación controlada o una actualización de la política de códecs, pero no es una transcodificación mágica en el mismo lugar. La importación descarga una variante seleccionada y la exportación crea otro video. Trátalo como una migración con identidad explícita, revisión y reversión, en lugar de como una actualización de formato inofensiva. ## En esta guía 1. [Decide qué representa el nuevo registro de Vimeo](#vimeo-import-encode-republish-workflow-section-1) 2. [Elige la variante importada de forma deliberada](#vimeo-import-encode-republish-workflow-section-2) 3. [Construye el Template privado de republicación](#vimeo-import-encode-republish-workflow-section-3) 4. [Concilia los metadatos y las funciones de la plataforma](#vimeo-import-encode-republish-workflow-section-4) 5. [Controla la concurrencia y los reintentos](#vimeo-import-encode-republish-workflow-section-5) 6. [Completa la transición sin perder la posibilidad de reversión](#vimeo-import-encode-republish-workflow-section-6) ## Lo más importante * Exporta con acceso restrictivo de Vimeo hasta verificar los metadatos y la reproducción. * Registra los identificadores de video de origen y destino para que las reejecuciones no creen duplicados invisibles. * Regula y reintenta ante los límites de la API de destino sin reiniciar las exportaciones exitosas. ## Decide qué representa el nuevo registro de Vimeo Una importación desde Vimeo seguida de una exportación a Vimeo crea un nuevo video de destino. Define si ese registro reemplaza a una fuente en otra cuenta, representa una variante recién gobernada o es solo un experimento privado. Sin ese propósito, el flujo de trabajo produce duplicados cuya propiedad y audiencia no quedan claras. Crea un registro de migración de la aplicación antes de comenzar. Guarda la cuenta de origen y la identidad del video, la variante seleccionada, la cuenta de destino, los metadatos previstos, la versión del flujo de trabajo, el ID de la Assembly y la identidad resultante en Vimeo. Ese mapeo es la base para la deduplicación, la revisión y la reversión. ## Elige la variante importada de forma deliberada /vimeo/import selecciona la variante fuente o una variante numérica con nombre entre 240p y 1080p. Usa source cuando el flujo de trabajo necesite la variante fuente, y elige una variante numérica cuando la resolución de salida y el costo de migración estén deliberadamente acotados. El ejemplo elige 1080p como entrada acotada, no como copia de preservación. El Step de codificación amplía una variante importada más pequeña a menos que zoom esté configurado como false, por lo que una importación en 720p recodificada a 1080p agrega píxeles en lugar de detalle. Pagina según la ruta de la API de Vimeo y el número de página. Una página es una unidad de trabajo conveniente, no una garantía de idempotencia; las colecciones de Vimeo pueden cambiar mientras se ejecuta la migración. Toma una instantánea o registra las identidades de las fuentes para que los videos recién agregados o reordenados no alteren el lote de forma silenciosa. ## Construye el Template privado de republicación El Step de codificación solo lee la importación de Vimeo y produce un MP4 controlado. El Step de almacenamiento lee el resultado codificado y crea un video de destino con acceso restrictivo. El ejemplo usa acl configurado en nobody, lo que permite al propietario inspeccionar el destino antes de que se conceda acceso a cualquier audiencia. Usa credenciales de Template separadas para el origen y el destino al moverte entre cuentas. Mantén el título, la descripción, la carpeta, los Showcases y la política de acceso en una configuración de migración confiable. Un título derivado del nombre de archivo puede ser aceptable para un archivo de prueba privado, pero los metadatos de producción deberían provenir de un registro fuente aprobado. Importar una página de Vimeo y crear videos de destino normalizados privados ``` { "allow_steps_override": false, "steps": { "vimeo_sources": { "robot": "/vimeo/import", "credentials": "vimeo-source-account", "path": "me/videos", "rendition": "1080p", "page_number": 1, "files_per_page": 3 }, "normalized_mp4": { "use": "vimeo_sources", "robot": "/video/encode", "preset": "web/mp4/1080p", "width": 1920, "height": 1080, "resize_strategy": "fit", "zoom": false }, "vimeo_destination": { "use": "normalized_mp4", "robot": "/vimeo/store", "credentials": "vimeo-destination-account", "title": "${file.original_basename} — normalized", "description": "Private migration candidate from ${file.original_name}", "acl": "nobody", "downloadable": false, "result": true } } } ``` ## Concilia los metadatos y las funciones de la plataforma Los bytes multimedia son solo una parte de un registro de Vimeo. Los comentarios, las analíticas, el historial de revisión, las miniaturas personalizadas, los subtítulos, los Showcases, las carpetas, la privacidad, la configuración de descarga y los enlaces de la aplicación pueden requerir un manejo independiente. Haz un inventario de cada aspecto y decide si se migra, se reconstruye, se omite intencionalmente o se conserva solo en la fuente. No elimines ni ocultes la fuente solo porque la nueva subida se haya completado con éxito. Verifica la duración, las pistas, el audio, la calidad visual, los metadatos, la ubicación de la carpeta, el acceso y cualquier inserción posterior. Cambia las referencias de la aplicación y la disposición de la fuente solo después de que el destino pase esas verificaciones. ### Resultado multimedia El video de destino tiene la duración, las pistas y la calidad visual esperadas. ### Resultado de la plataforma La privacidad, los metadatos, la carpeta, los Showcases y el comportamiento de descarga cumplen con la política. ### Resultado de la aplicación El mapa de identidad del antiguo al nuevo registro es duradero y los consumidores apuntan al registro previsto. ## Controla la concurrencia y los reintentos Los límites de subida de Vimeo dependen del plan de la cuenta conectada. files\_per\_page controla cuántos archivos recupera /vimeo/import por página; no es un control documentado de concurrencia de exportación. Una página más grande le da a los Steps posteriores más videos para procesar en la ejecución. Mantén pequeñas las primeras páginas, aumenta el tamaño de página solo después de medir la tolerancia de la cuenta de destino y reduce la frecuencia ante limitaciones del proveedor. Encola de forma explícita los registros fuente para que una respuesta temporal del proveedor no reinicie una codificación ya exitosa ni exporte videos no relacionados dos veces. Gestiona por separado las credenciales expiradas, las variantes de fuente no disponibles, los fallos de codificación, los rechazos de destino y las devoluciones de llamada de finalización perdidas. Antes de reintentar una exportación, verifica la Assembly y el registro de migración existentes. Un tiempo de espera incierto debería entrar en conciliación, no crear automáticamente otro video de Vimeo. ## Completa la transición sin perder la posibilidad de reversión Mueve los elementos incrustados de la aplicación, la pertenencia a colecciones y las referencias visibles para el usuario solo después de que el registro de destino pase la revisión. Conserva el mapa de fuente a destino y una fecha límite de reversión. Si un destino se rechaza o se elimina más tarde, los operadores deberían poder localizar la fuente exacta y volver a ejecutar el flujo de trabajo previsto sin buscar por título. Retira o elimina los videos fuente mediante una operación separada y revisada. El Template de migración no debería realizar cambios destructivos en Vimeo, porque el éxito de la exportación por sí solo no demuestra que se hayan trasladado todas las funciones de la plataforma y todos los consumidores posteriores. ## Detalles técnicos que conviene conocer * /vimeo/import admite rutas de la API de Vimeo como me/videos y pagina con page\_number y files\_per\_page, con un límite de esquema de 100 archivos por página. * /vimeo/import acepta la variante de fuente o una de cinco variantes numéricas entre 240p y 1080p. La variante seleccionada es la entrada del Step de codificación. Este ejemplo elige deliberadamente 1080p para acotar la resolución importada; no es un flujo de trabajo de preservación. * /vimeo/store acepta videos y crea un registro de destino con título, descripción, control de acceso, Showcases opcionales y ubicación de carpeta opcional. * Los valores de acceso de exportación de Vimeo incluyen anybody, contacts, disable, nobody, password, unlisted y users. El campo password solo es relevante cuando acl es password. * La documentación de Vimeo store advierte que los límites de subida concurrente dependen del plan de la cuenta de Vimeo conectada. * Importar y exportar a través del mismo proveedor no conserva los comentarios, las analíticas, el historial de revisión ni la identidad original del video, a menos que la aplicación migre o mapee esos aspectos por separado. ## Un enfoque práctico 1. 1\ Inventaría los videos fuente, la propiedad de destino, los metadatos, los Showcases, la privacidad y las reglas de reemplazo. 2. 2\ Crea credenciales separadas de origen y destino de Vimeo y guarda el Template bloqueado. 3. 3\ Migra una página pequeña de forma privada y verifica las pistas, la duración, el audio, los metadatos y la ubicación de carpetas. 4. 4\ Concilia identidades, publica de forma deliberada y conserva un registro de reversión antes de escalar el lote. Un flujo de trabajo multimedia de cuatro etapas ## Cuándo resulta útil Transloadit Usa /vimeo/import para una página o colección acotada, /video/encode para un resultado MP4 conocido y /vimeo/store para la cuenta de destino. Usa credenciales de Template de origen y destino separadas para migraciones de cuentas, comienza con acl configurado en nobody y registra la asignación de identidad de Vimeo antigua a nueva. ## Límite de la arquitectura Este flujo de trabajo crea nuevos registros de video de Vimeo a partir de variantes importadas. No edita un video fuente en el mismo lugar, no conserva automáticamente todas las funciones del lado de Vimeo, ni decide cuándo el nuevo registro debe reemplazar al anterior en una aplicación o colección. ## Preguntas frecuentes ### ¿Esto actualiza un video de Vimeo en el mismo lugar? No. El Step de almacenamiento crea un video de destino. Trata el flujo de trabajo como una migración o una republicación y conserva un mapa explícito de identidad, de la antigua a la nueva. ### ¿Qué variante de Vimeo se debe importar? Usa source cuando el flujo de trabajo deba importar la variante fuente. Elige una variante numérica, como los 1080p del ejemplo, cuando quieras deliberadamente una resolución acotada o un costo de migración limitado. La variante importada es el material que recibe el Step de codificación, por lo que acota la calidad de todo lo que sigue. ### ¿Se puede usar una sola credencial para ambos Steps? Sí, para la misma cuenta conectada, pero usar credenciales de origen y destino separadas es más claro y seguro para migraciones de cuentas. ### ¿Qué configuración de acceso debe usar el destino? Comienza con nobody u otra política restrictiva, verifica el resultado y luego concede acceso al público previsto mediante una transición autorizada. ### ¿Se migran los comentarios y las analíticas? No mediante este flujo de trabajo multimedia de tres Steps. Los registros y el historial del lado de la plataforma requieren un plan de migración independiente o una retención deliberada en el video de origen. ## Crea el flujo de trabajo Pasa del concepto a una Assembly probada con documentación de Robots y demos funcionales. ### Robots relevantes * [/vimeo/import EN (English)](/docs/robots/vimeo-import.md) * [/video/encode](/es/docs/robots/video-encode.md) * [/vimeo/store EN (English)](/docs/robots/vimeo-store.md) * [Importa videos desde Vimeo EN (English)](/docs/robots/vimeo-import.md) * [Normaliza la variante de video](/es/docs/robots/video-encode.md) * [Exporta videos a Vimeo EN (English)](/docs/robots/vimeo-store.md) * [Separa las credenciales de cuenta](/es/docs/topics/template-credentials.md) * [Concilia los resultados de la migración](/es/docs/topics/webhooks.md) * [Lee la documentación de la API](/es/docs.md) * [Explora demos funcionales EN (English)](/demos.md) * [Crea un Workspace gratuito](/c/signup/) Procesamiento y creación de video ## Continúa con guías relacionadas * [Flujos de trabajo de procesamiento multimedia personalizables con Transloadit](/es/guides/customizable-media-processing-workflows.md)\ Diseña un Template reutilizable con validación, variables, derivados paralelos, almacenamiento seguro y finalización observable. * [Cómo evaluar API de video en vivo y bajo demanda](/es/guides/video-streaming-api-evaluation.md)\ Evalúa las API de video en vivo y bajo demanda por ingesta, latencia, reproducción, procesamiento, almacenamiento, observabilidad y responsabilidad. * [Controla los códecs de video y audio con Transloadit](/es/guides/control-video-audio-codecs.md)\ Elige ajustes preestablecidos de audio/video y un stack de FFmpeg, anula sus opciones admitidas y prueba salidas de códec sin operar una flota de codificación. * [Subir, codificar y publicar un video en YouTube](/es/guides/upload-encode-publish-video-youtube.md)\ Recibe la subida de un video, crea una variante MP4 controlada y publícalo de forma privada en YouTube mediante un flujo de trabajo revisable.