GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Todas las guías

· reAPI Team

Retención de datos de API: guarda los resultados antes de que caduquen los enlaces

Planifica la retención de datos de API para archivos generados, cargas de entrada y copias de seguridad. Guarda los resultados antes de que caduquen los enlaces, verifica las copias y comprueba qué elimina el borrado.

Retención de datos de API: guarda los resultados antes de que caduquen los enlaces

El video terminó de generarse correctamente. Tu base de datos contiene el ID de la tarea y una URL de descarga. Eso basta para indicar dónde estuvo el resultado, pero no constituye un archivo del video.

El valor predeterminado documentado de Replicate hace urgente esta distinción: las entradas, los valores de salida, los archivos de salida y los registros de las predicciones de API se eliminan al cabo de una hora. Las predicciones creadas en su sitio web siguen otra regla y permanecen hasta que se eliminan manualmente.[1] Que aún puedas ver un archivo en una sesión web no indica cuánto tiempo seguirá disponible para descargar un resultado de API.

Si necesitas un resultado más adelante, el flujo de finalización debe copiar los bytes reales a un almacenamiento que controles y verificar esa copia. Al eliminar, tendrás que tener en cuenta tanto la versión del proveedor como las copias que hayas creado. Sigue un archivo a través de estos pasos y las preguntas sobre retención se volverán concretas.

Asigna al archivo descargado un estado de finalización propio

Imagina un video generado. La generación termina y un proceso de archivo empieza a copiar el resultado. Mantén separados los estados «generación completada» y «copia verificada». Si falla la descarga, el primer estado puede ser verdadero mientras el segundo sigue siendo falso.

Lee los campos de salida documentados de la tarea completada e identifica cada archivo que quieras conservar. Si una tarea tiene varios resultados, guarda el índice de salida o una identificación equivalente junto con el ID de la tarea. Un único indicador de éxito no permite saber cuál de los varios archivos se copió.

Descarga el archivo mediante la ruta de acceso autorizada de tu aplicación, escribe el objeto de destino y compruébalo antes de presentarlo como guardado de forma duradera. Confirma que el objeto esperado existe, que la transferencia terminó y que su tamaño y tipo de medio son plausibles. Cuando sea práctico, abre o decodifica tu copia. Una suma de verificación puede confirmar que los bytes coinciden con los descargados; no demuestra que la escena generada sea correcta ni que el video cumpla la solicitud del cliente.

Guarda juntos la URL original, el ID de la tarea, la identificación del resultado, la clave del objeto de destino y la hora de la copia. Para que la aplicación acceda al archivo más adelante, usa tu propia identificación del objeto. Guardar la URL temporal del proveedor en otra columna de la base de datos no crea una copia independiente.

Si vuelve a llegar la misma notificación de finalización, usa las identificaciones de la tarea y del resultado para reconocer una copia ya verificada. Reintenta una transferencia incompleta cuando corresponda, pero evita crear duplicados sin explicación solo porque se repitió la notificación. Este es un flujo de trabajo propuesto para la aplicación, no una afirmación de que todos los proveedores archiven los archivos por ti.

El proceso puede fallar después de que el modelo termine correctamente

En el ejemplo del video, supón que el proceso de archivo no está disponible cuando termina la generación. La copia debe quedar pendiente. Cuando vuelva a estar disponible, puede intentar recuperar el archivo mientras la fuente siga accesible. Si la fuente ha caducado, registra el fallo de conservación en vez de marcar la tarea como archivada sin avisar.

No vuelvas a generar el video y presentes eso como la recuperación del archivo original. Otra generación es otra operación, puede producir contenido distinto o generar otro cargo. Primero comprueba si ya existe una copia verificada o si el proveedor documenta otra forma de recuperación. Por ejemplo, fal indica que los archivos CDN caducados se eliminan definitivamente y no se pueden recuperar.[2]

Por tanto, el periodo de retención es un dato que debe orientar el diseño del trabajo de copia. Si la aplicación no puede archivar de forma fiable dentro del plazo aplicable, cambia ese flujo o prepara un almacenamiento documentado antes de prometer acceso posterior. Que un enlace haya funcionado más tiempo en una observación no garantiza que los archivos se almacenen durante ese periodo.

La documentación de tareas de reAPI también aconseja copiar pronto los resultados generados para archivarlos a largo plazo. Describe resultados CDN alojados de nuevo e indica que las políticas del ciclo de vida se configuran en cada implementación, en lugar de quedar garantizadas por ese contrato.[3] Esto respalda que guardes tu propia copia; no establece una fecha de caducidad fija ni un alojamiento permanente para todas las URL devueltas.

Para comprobar la recuperación, usa un recurso sintético autorizado y lee la copia de destino sin depender del enlace original del proveedor. Guarda el resultado de la comprobación. Es menos útil que se informe de que la carga se realizó correctamente que confirmar que la aplicación puede recuperar y usar el objeto que controlas.

Un registro de solicitud y un archivo multimedia pueden tener distintas duraciones

Según las reglas del servicio, la tarea del video hipotético puede seguir visible aunque el archivo ya no esté disponible. A la inversa, eliminar el contenido de la solicitud no tiene por qué eliminar todos los objetos multimedia. Identifica el objeto antes de asignarle un periodo de retención.

fal documenta que las entradas y salidas del historial de solicitudes se conservan durante 90 días de forma predeterminada. Los archivos CDN tienen un periodo de retención configurable por separado. X-Fal-Store-IO: 0 controla el almacenamiento de las cargas útiles del historial de solicitudes; X-Fal-Object-Lifecycle-Preference controla la duración de los medios, y los ajustes por solicitud prevalecen sobre los valores predeterminados de la cuenta.[2] El ajuste del historial, por sí solo, no desactiva todo el almacenamiento.

Una entrada cargada añade otro objeto. Puede que tu imagen de origen permanezca en tu bucket mientras se usa una copia del proveedor para generar el video. Conserva la relación entre esas copias si más adelante hay que eliminarlas. La duración del video de salida no determina la duración de su imagen de referencia.

Las colecciones y las vistas compartidas son otra capa. fal indica que habilitar Assets, añadir un archivo a una colección o compartirla no amplía la duración del archivo subyacente.[4] Una relación guardada en la biblioteca puede durar más que el medio utilizable al que apunta.

El mismo razonamiento se aplica a los flujos de trabajo con documentos. Las anotaciones PDF reutilizables pueden contener contenido extraído, no solo referencias a un archivo. Si tu aplicación las almacena, incluye esa copia en las decisiones de retención junto con el documento original.

Eliminar el elemento de la biblioteca no equivale a eliminar el archivo

Supón que el video ya está archivado en tu bucket y quieres eliminar la versión del proveedor. Elige la operación que corresponda a ese objetivo. Ocultarlo en una biblioteca, quitarlo de una colección y eliminar el archivo CDN son acciones distintas.

La documentación de Assets de fal indica que eliminar un recurso lo quita de la biblioteca y de los resultados de búsqueda, pero no elimina por sí solo el archivo CDN subyacente. Quitar un recurso de una colección tiene un alcance aún más limitado: puede seguir en la biblioteca y en otras colecciones.[4] Comprobar solo la colección después de quitarlo verifica la vista, no que el archivo se haya eliminado.

Para una generación completada, fal documenta una operación independiente para eliminar la carga útil de la solicitud que también afecta a los archivos de salida CDN. No elimina los archivos de entrada CDN, que pueden reutilizarse en otras solicitudes.[2] Si también hay que eliminar la imagen de referencia, comprueba primero si se necesita en otro lugar y luego tramita su eliminación con la operación de archivo adecuada.

Inspecciona el resultado a nivel de archivo. La respuesta de eliminación de fal contiene cdn_delete_results, con el enlace afectado y un valor exception para cada archivo; null indica que la eliminación de ese elemento se completó correctamente.[5] Una respuesta general no es motivo para ignorar una excepción notificada para uno de varios resultados.

Registra la hora de la operación, los objetivos y los fallos sin resolver. Que después falle una descarga aporta información sobre esa ruta de recuperación, pero no demuestra que hayan desaparecido todas las copias de seguridad internas o posteriores. Limita lo que afirmas sobre la eliminación al alcance de la operación documentada y a los resultados que hayas comprobado realmente.

La acción Delete del sitio web de Replicate tiene su propio alcance documentado: elimina la predicción y los datos y archivos de salida asociados.[1] Aplica la regla correspondiente a la ruta de creación en cuestión en vez de dar por hecho que todos los botones de eliminación de los paneles funcionan como la acción de biblioteca de fal.

Sigue las copias en las exportaciones y las copias de seguridad

Eliminar la versión del proveedor no elimina el video que ahora está en tu bucket. Si el cliente descargó una exportación, esa es otra copia. Revocar un enlace compartido detiene el acceso mediante ese enlace, pero no recupera los archivos que los destinatarios ya descargaron; las indicaciones de fal para compartir distinguen expresamente estos resultados.[4]

Para las copias que controlas, conserva junto al objeto la identificación de la tarea y del resultado, el propietario, la ubicación de almacenamiento y la regla de eliminación. Así podrás atender una solicitud de eliminación posterior sin depender de una URL temporal o de un nombre de archivo de exportación sin etiqueta. Incluye las vistas previas generadas, las versiones guardadas y las copias de migración que cree tu flujo de trabajo.

También hace falta decidir qué hacer con las copias de seguridad. Consérvalas para el propósito de recuperación previsto y ten en cuenta cómo conciliar los datos restaurados con las eliminaciones posteriores. De lo contrario, restaurar una copia antigua puede volver a introducir contenido que la aplicación ya había eliminado. Durante una migración de almacenamiento, verifica el destino antes de cambiar las referencias y traslada con los datos la decisión sobre la propiedad y la retención.

Los originales, las vistas previas y las copias de seguridad también ocupan espacio en el almacenamiento de destino. Al estimar ese coste, cuenta las copias y cuánto tiempo se conserva cada una; eliminar la versión del proveedor no suprime el coste de tu propio archivo.

Los contratos de resultados generados que se tratan aquí no establecen un requisito universal de retención de siete años. Los distintos tipos de registros pueden tener requisitos diferentes; el periodo aplicado a una factura no debe convertirse automáticamente en la duración de cada video generado. Define la política aplicable al objeto y al propósito en vez de elegir un plazo conocido.

¿Dónde se almacenan los datos? En este ejemplo, puede haber historial de solicitudes del proveedor, medios CDN, tu objeto propio, exportaciones y copias de seguridad. La residencia geográfica es una cuestión contractual aparte. Una URL multimedia no indica dónde se procesa o almacena cada copia.

Trata por separado las cuestiones de almacenamiento, uso compartido y entrenamiento

Que se diga que los datos no se utilizan para entrenamiento no demuestra que nunca se almacenen. La guía de datos de API de OpenAI distingue los registros de supervisión de uso indebido del estado de la aplicación. Los controles de Zero Data Retention están disponibles para clientes que cumplen los requisitos y han recibido aprobación, y siguen sujetos a limitaciones de endpoints y funciones.[6] Confirma el alcance aplicable a la organización, el proyecto y la operación concretos.

fal también indica que sus ajustes del historial de solicitudes y CDN no configuran el registro de la aplicación del propietario de la implementación ni el almacenamiento persistente que gestiona la aplicación. Pide a quienes necesitan ZDR que confirmen qué endpoints están cubiertos.[2] Un solo encabezado no puede describir todas las copias de un flujo de trabajo que también utiliza una aplicación, herramientas y tu propio almacenamiento.

Para el video hipotético, el registro final debería responder ahora a dos preguntas prácticas: ¿qué copia verificada se utilizará para futuras descargas?, y ¿qué otras copias se eliminaron o siguen sujetas a una regla indicada? Mantén visibles los fallos de transferencia y las excepciones de eliminación por archivo hasta resolverlos. Así, la aplicación podrá distinguir entre una generación completada, un archivo utilizable y una eliminación completada sin fingir que son el mismo evento.

Referencias

  1. Replicate, «Data retention», documentación oficial de predictions. Consultada el 16 de noviembre de 2026; los valores predeterminados de la API y la eliminación desde el sitio web tienen alcances distintos.
  2. fal, «Data retention and storage», documentación oficial de Model APIs. Consultada el 16 de noviembre de 2026; el historial de solicitudes, CDN y las responsabilidades del propietario de la implementación son distintos.
  3. reAPI, documentación de tareas, formato de salida e indicaciones de archivo. Revisada el 16 de noviembre de 2026.
  4. fal, «Retention and deletion», documentación oficial de Assets. Consultada el 16 de noviembre de 2026; acciones de biblioteca, duración de los archivos y copias descargadas.
  5. fal, «Delete request payloads», referencia oficial de Platform API. Consultada el 16 de noviembre de 2026; resultados de eliminación por archivo. No se realizó ninguna eliminación para esta guía.
  6. OpenAI, Tus datos. Consultada el 16 de noviembre de 2026; política de entrenamiento, controles de retención y limitaciones de los endpoints.
Todas las guías