# ¿Cómo guardar videos generados con IA antes de que caduquen los enlaces temporales? > Guarda los videos tratando las URL del proveedor como credenciales de transferencia de corta duración, no como ubicaciones del activo. Encola la descarga en cuanto termine el trabajo, transmite el archivo a un almacenamiento de objetos duradero, verifica tamaño, tipo y checksum, y registra la URI permanente antes de marcar completa la producción. # ¿Cómo guardar videos generados con IA antes de que caduquen los enlaces temporales? Una generación terminada no es un activo duradero hasta que sus bytes existen en un almacenamiento bajo tu control. Muchas API devuelven una URL firmada o temporal diseñada para transferir, no para reproducir a largo plazo. Guardar únicamente esa URL puede hacer que un video aprobado desaparezca de la aplicación horas o días después. Crea un paso de ingestión separado que comience al terminar la generación. Reclama una tarea de descarga, obtiene una URL actual, transmite el medio a un objeto temporal, lo valida y lo promueve a una clave permanente determinista. Solo entonces debe quedar completo el trabajo de producción. ## Trata la URL como una credencial Una URL firmada suele conceder acceso temporal sin otro header de autorización. Por eso es sensible. No la expongas en analítica, logs visibles, tickets o campos permanentes salvo que el acceso esté controlado. Guarda en su lugar: * ID de trabajo del proveedor; * identificador de salida cuando exista; * hora de emisión y vencimiento observado; * registros de intentos de descarga; * clave final de almacenamiento; * metadatos de verificación y checksum. Si el proveedor devuelve una caducidad explícita, programa la descarga con margen. Si no publica duración, asume que el enlace es efímero y encola la transferencia de inmediato. ## Separa generación e ingestión Completar la generación y guardar de forma duradera son estados distintos. Un trabajo puede triunfar remotamente y fallar al descargarse. | Estado | Significado | Siguiente acción | |---|---|---| | `generating` | El proveedor crea el video | Consultar o esperar webhook | | `output_ready` | La salida está terminada | Encolar descarga | | `downloading` | Un worker posee el intento | Transmitir a almacenamiento temporal | | `verifying` | Llegaron los bytes | Inspeccionar y calcular checksum | | `stored` | Se confirmó el objeto duradero | Guardar URI permanente | | `complete` | Activo y metadatos están confirmados | Entregar | | `download_retry` | Hubo un fallo transitorio | Renovar URL y reintentar | | `needs_attention` | No puede recuperarse automáticamente | Escalar con evidencia | No marques completo el trabajo en `output_ready`. Ese atajo causa que la base de datos termine apuntando a enlaces caducados. ## Confirma los webhooks antes de descargar El controlador debe validar y guardar el evento, encolar la salida y responder rápido. Descargar un video grande dentro del webhook arriesga un timeout y entregas repetidas. Deduplica por ID de evento o por combinación de ID de trabajo y salida. Haz idempotente la cola con una clave como: ```text download_key = provider + provider_job_id + output_id ``` Los webhooks repetidos convergen así en una tarea. Las consultas y los webhooks pueden llamar a la misma operación `ensure_download_task`. ## Transmite a un objeto temporal Evita leer la respuesta completa en memoria. Transmite bloques a un archivo temporal o una carga multiparte mientras calculas un checksum criptográfico. Una secuencia segura es: 1. Reclamar la tarea con un arrendamiento que caduque. 2. Obtener una URL nueva si la API lo permite. 3. Enviar con timeouts limitados de conexión y lectura. 4. Rechazar redirecciones a hosts inesperados según la política. 5. Transmitir bloques contando bytes y calculando SHA-256. 6. Cerrar y finalizar el objeto temporal. 7. Validar el medio. 8. Promoverlo o copiarlo a la clave final. 9. Confirmar la URI y los metadatos. Usa contrapresión para no almacenar datos más rápido de lo que el destino acepta. Limita la concurrencia según ancho de banda, tamaño y capacidad del almacenamiento, no solo por número de trabajos. ## Valida bytes, no solo headers Un HTTP `200` puede contener HTML, JSON o un archivo truncado. `Content-Type: video/mp4` es evidencia útil, pero no una prueba. | Validación | Fallo detectado | |---|---| | Número de bytes mayor que cero | Respuesta vacía | | Longitud esperada o plausible | Transferencia truncada | | Firma del archivo | HTML o JSON guardado como video | | Análisis del contenedor | Estructura dañada | | Duración mayor que cero | Video incompleto | | Dimensiones y códec | Salida fuera del contrato | | Checksum SHA-256 | Bytes cambiados o duplicados | | Muestra de decodificación | Medio que analiza pero no reproduce | Guarda los metadatos observados. Compáralos con duración y resolución solicitadas usando tolerancias adecuadas. No rechaces un video válido por una diferencia de pocos fotogramas salvo que el contrato exija exactitud. ## Usa claves duraderas deterministas Una clave predecible hace idempotentes los reintentos y mantiene trazabilidad. Incluye identidad empresarial, variante y versión o checksum. ```text videos/{account}/{operation_id}/{attempt_id}/{output_id}-{sha256_prefix}.mp4 ``` Escribe primero en un espacio temporal. Tras validar, promueve el objeto o confirma un puntero a la clave verificada. Si otro worker ya guardó el mismo checksum para la tarea, reutilízalo. No pongas nombres proporcionados por usuarios en rutas sin sanearlos. Guarda el nombre original como metadato. ## Recupérate de caducidad e interrupciones Clasifica los errores para reintentar con propósito. * Los reinicios de conexión y errores temporales de almacenamiento suelen permitir espera y reintento. * Una respuesta de autorización o caducidad puede requerir una URL nueva. * Un no encontrado puede significar que el proveedor eliminó el activo. * Los fallos repetidos de checksum o validación deben detener reintentos. * Una cuota o permiso local exige acción operativa, no otra llamada al proveedor. Conserva el ID remoto. Muchas API pueden emitir una URL nueva para un trabajo terminado. Verifica ese comportamiento para el endpoint actual. Reanuda descargas parciales solo cuando origen y destino admitan rangos verificados y la identidad del objeto no cambie. En caso contrario, reinicia en otro objeto temporal. ## Elige un calendario que respete la caducidad Una espera exponencial ordinaria puede superar la vida restante de la URL. Limítala con la caducidad conocida: ```text next_delay = min(exponential_backoff, time_until_expiry - safety_margin) ``` Si la URL está cerca de caducar, renuévala antes de reintentar. Añade aleatoriedad para evitar que todos los workers reconecten a la vez. Limita por separado los intentos de transferencia y de renovación. Un trabajo que reciba archivos no válidos no debe consumir URL sin límite. ## Protege la ruta de almacenamiento El objeto permanente debe seguir tu política de acceso. Usa buckets privados por defecto, cifrado cuando corresponda, credenciales mínimas y URL cortas para los espectadores. No copies la cadena de consulta de la URL en metadatos porque puede contener firmas. Redáctala en logs o guarda solo host, hash de ruta, emisión y vencimiento. Aplica análisis de malware o moderación si el producto lo requiere. Mantén límites entre inquilinos en claves y autorización, pero no dependas solo del nombre de ruta. ## Define retención y derivados Duradero no significa permanente. Define ciclos de vida para originales, másteres aprobados, vistas previas e intentos rechazados. | Clase de activo | Consideración de política | |---|---| | Máster aprobado | Contrato y coste de regeneración | | Derivado de entrega | Puede recrearse desde el máster | | Generación rechazada | Ventana corta de auditoría | | Carga temporal | Borrado automático tras verificación | | Proxy de revisión | Conservar hasta la aprobación | Registra estado y motivo de borrado. Si el activo debe ser reproducible, conserva prompt, hashes, modelo, parámetros y derechos, sabiendo que una generación no determinista puede no recrear los mismos bytes. ## Controla el tiempo hasta la durabilidad Mide el intervalo desde que termina el proveedor hasta el almacenamiento verificado. Es la ventana de riesgo donde el enlace temporal puede ser la única copia. Métricas útiles: * salidas esperando descarga; * edad de la salida lista más antigua; * percentiles de finalización a almacenamiento; * respuestas de URL caducada; * reintentos y renovaciones; * fallos de checksum o validación; * bytes descargados y guardados; * trabajos completos sin URI duradera. La última métrica debe ser cero. Alerta antes de que la cola se acerque a la vida más corta observada de una URL. ## Aclara responsabilidades de modelo y almacenamiento [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=save-ai-videos-before-download-links-expire) puede ofrecer una plataforma compatible con OpenAI para acceder a modelos de texto, imagen y video. Una plataforma unificada simplifica metadatos y facturación, pero la aplicación sigue siendo responsable de copiar las salidas a un almacenamiento que cumpla sus requisitos. Verifica el comportamiento de salida y renovación del endpoint exacto. No inventes una caducidad ni supongas que todos los modelos descargan igual. Gestiona las diferencias mediante configuración y comprobaciones de capacidad. ## En resumen Guarda videos generados con IA tratando las URL temporales como credenciales de transferencia. Encola la descarga al terminar, transmite a un objeto temporal, valida el medio y promuévelo a una clave duradera. Registra la URI permanente y el checksum antes de declarar completo el trabajo, y diseña renovación, reintentos, retención y supervisión para que un enlace pueda caducar sin llevarse tu única copia. ## FAQ ### ¿Puedo guardar la URL de descarga del proveedor como ubicación final del video? No. Las URL firmadas o temporales pueden caducar, revocarse o cambiar. Guarda la clave duradera y el ID del trabajo, y solicita o usa una URL de transferencia nueva solo cuando sea necesario. ### ¿Debe el worker cargar todo el video en memoria? Normalmente no. Transmite la respuesta a un archivo temporal o una carga multiparte mientras calculas un checksum para que los archivos grandes no agoten la memoria. ### ¿Qué debe verificarse antes de marcar un video como guardado? Verifica la respuesta HTTP, la longitud cuando exista, la firma del archivo, el contenedor esperado, una duración mayor que cero, dimensiones o códec, checksum y escritura correcta en el almacenamiento duradero. ### ¿Qué ocurre si la URL caduca durante la descarga? Conserva el trabajo y el ID remoto, descarta o aísla el objeto incompleto, solicita una URL nueva si la API lo permite y reanuda o reinicia según el soporte verificado de rangos. ### ¿Cuánto tiempo deben conservarse los videos originales? Define la retención según las necesidades del cliente, requisitos legales y de privacidad, coste de regeneración y presupuesto de almacenamiento. Usa políticas de ciclo de vida, no dependas accidentalmente de URL del proveedor. ### ¿Puede un webhook descargar directamente el video? El controlador del webhook debe confirmar rápido y encolar una descarga. Un worker independiente puede reintentar con seguridad, verificar el activo y evitar perder eventos por transferencias largas.