Importar vídeos

TubePress puede llenar tu biblioteca de varias maneras — desde añadir un solo clip a mano hasta importar cientos de miles de vídeos listos desde la nube. Esta página cubre el importador integrado y te muestra dónde encontrar cada otra opción.

Cualquiera que sea el método que elijas, el resultado es el mismo: vídeos ordinarios que puedes editar, organizar, moderar y publicar como cualquier otro. Elige el que se adapte a la cantidad de contenido que tienes y a si quieres una carga puntual o algo que se actualice automáticamente.

Formas de añadir contenido a TubePress

No existe una única forma "correcta" de añadir vídeos — cada método se adapta a una escala y flujo de trabajo diferente. Usa la tabla a continuación para elegir y luego sigue el enlace para ver los detalles.

Importar un solo vídeo

TubePress no tiene un importador separado para "un vídeo" — para añadir un solo vídeo, usa la pantalla Vídeos en /admin/videos y elige Añadir vídeo. Hay dos formas de proporcionar el contenido:

• Subida manual — sube un archivo de vídeo que tú mismo alojas.
• Importación por URL — pega un código de incrustación <iframe> o una URL de vídeo directa para incrustar un clip alojado en otro lugar.

Rellena el título y la miniatura, adjunta categorías, etiquetas o intérpretes, y luego guarda como borrador o publica de inmediato. Ninguna de las dos opciones consume créditos.

Importación masiva

La importación masiva se encuentra en la pestaña Subir archivo de /admin/import. Acepta un único archivo CSV o JSON — no una lista de URL pegadas — y convierte cada fila u objeto en un vídeo.

• CSV debe tener una fila de encabezado y usar comas como separadores.
• JSON debe ser un array de objetos.

Arrastra el archivo sobre la zona de subida (o haz clic para buscar) y TubePress leerá las columnas y mostrará una vista previa. Un CSV mínimo tiene este aspecto:

title,embed_code,thumbnail,duration,tags
My clip,https://ex.com/v/123.mp4,https://ex.com/t.jpg,612,"solo,hd"

A continuación, mapea tus columnas a los campos de TubePress arrastrándolas a su lugar. Los campos que el importador reconoce incluyen:

Antes de empezar, configura cómo se manejan los duplicados (omitir o actualizar, según el video_id), si descargar miniaturas para servirlas desde tu almacenamiento, y cualquier reescritura o traducción opcional con IA.

Cómo funciona la cola de importación

Para archivos que superen un tamaño pequeño, elige Iniciar en segundo plano. TubePress crea un trabajo y lo entrega al procesador de importación, que procesa tus filas incluso después de cerrar la pestaña. No se necesita crontab del sistema — funciona con el pseudo-cron integrado.

El procesador está diseñado para ser seguro y resistente:

• Por bloques. Las filas se importan de a pocas a la vez para que un proceso web nunca quede bloqueado; una velocidad de importación ajustable controla cuántas por bloque.
• Asíncrono. El pseudo-cron toma el trabajo a medida que el sitio recibe tráfico, y la página de importación lo impulsa mientras está abierta.
• Auto-recuperable. Un trabajo que se detiene — por ejemplo, un reinicio del servidor a mitad de la ejecución — se vuelve a poner en cola automáticamente después de unos cinco minutos y continúa donde lo dejó.
• Sin duplicados. Las filas con un video_id conocido se omiten o actualizan en lugar de duplicarse.
• Tolerante a errores. Una fila incorrecta queda registrada (se muestran los primeros errores por bloque) y el trabajo continúa.

Monitorizar el progreso de la importación

Abre /admin/import y observa la Cola de importación. Cada trabajo activo muestra conteos en tiempo real — importados, omitidos, errores y procesados del total — actualizados cada pocos segundos.

Desde aquí puedes pausar, reanudar, cancelar o eliminar un trabajo. Los trabajos de las últimas 24 horas permanecen listados para que puedas revisar lo sucedido, incluidos mensajes de error de muestra para las filas que fallaron.

Consejos y límites

• Solo se aceptan archivos .csv y .json; otros formatos son rechazados de inmediato.
• El mínimo práctico por fila es un título, un código de incrustación y una miniatura.
• El tamaño de subida está limitado por los valores upload_max_filesize y post_max_size de tu servidor. Divide archivos muy grandes o usa un trabajo en segundo plano.
• Mapea un video_id estable para que al volver a ejecutar un archivo se actualice en lugar de duplicarse.
• Activa Descargar miniaturas para alojar las imágenes en tu servidor en lugar de hacer hotlinking a la fuente.
• La reescritura y traducción con IA consumen créditos y requieren una cuenta de tubepress.io vinculada; si tu saldo es demasiado bajo, el trabajo se detiene con un mensaje claro.

Próximos pasos