4oImageApi.io solo conserva las imágenes 14 días: la generación asíncrona debe terminar con el archivado
Los equipos que integren 4oImageApi.io en un backend de diseño deben separar el éxito de la tarea de la entrega del recurso: seguir el estado mediante taskId y guardar los resultados en almacenamiento propio antes de que termine el plazo de conservación de 14 días. Un callback puede avisar de la finalización, pero no sustituye el archivado del archivo.
Después de conectar el backend de diseño a 4oImageApi.io, ¿se puede cerrar la tarea en cuanto llega el aviso de generación completada? No, si la imagen se necesita para una campaña del mes siguiente. La documentación oficial indica que las imágenes generadas solo se conservan 14 días. La generación asíncrona permite que el backend trate por separado «enviar la solicitud» y «obtener el resultado», pero el equipo debe añadir un paso de archivado del que se haga responsable.
Este análisis de una tarea interna de creación de recursos se basa en la documentación; no es una prueba real de la API. Supongamos que un diseñador solicita una imagen para una campaña. Lo que el desarrollador debe entregar es una imagen que pueda volver a abrirse en la biblioteca de recursos del equipo, no solo una tarea marcada como correcta en el servidor.
El callback avisa de la finalización; la consulta del estado ayuda a confirmar el resultado
La documentación explica que, al terminar una tarea, se envía una notificación POST a la URL de callback indicada. El endpoint de detalles permite consultar el estado de generación, los parámetros y los resultados mediante taskId. Durante la integración, conviene vincular la solicitud de imagen con su taskId en el registro de tareas propio para que las consultas posteriores permitan recuperar la solicitud original.
La interfaz también debe distinguir entre «generando» y «listo para que lo revise el diseñador». Los estados documentados incluyen GENERATING, SUCCESS, CREATE_TASK_FAILED y GENERATE_FAILED. Tras recibir un aviso, hay que comprobar el estado y el resultado antes de decidir si se sigue esperando, se gestiona un fallo o se pasa a revisar la imagen. No se debe interpretar cada notificación como la llegada de un recurso utilizable.
Si se emplean consultas periódicas, la documentación fija un máximo de 3 consultas por segundo y por tarea. Es un límite de consulta, no una frecuencia recomendada ni una promesa de generar 3 imágenes por segundo. El equipo debe ajustar el intervalo a la experiencia de espera deseada y detener las consultas repetidas cuando la tarea alcance un estado final. La supervisión del estado no debe confundirse con la capacidad de generación de imágenes.
La conservación de 14 días convierte el archivado en parte de la integración
Para una imagen que se usará el mes siguiente, apuntar únicamente la URL del resultado del proveedor en una tabla no es una medida suficientemente segura. Puesto que las imágenes caducan a los 14 días, hay que guardar el resultado seleccionado, dentro de ese plazo, en almacenamiento gestionado por el propio equipo y después anotar la ubicación interna del recurso en el registro de la tarea. Ese archivado es una responsabilidad que debe implementar la solución de integración. «Admite callbacks» no significa que el producto vaya a conservar los archivos permanentemente por ti.
La aceptación puede comprobarse sobre la misma solicitud: verificar que el resultado se abre, que la imagen cumple los requisitos de diseño y que la copia interna se puede leer de forma independiente; solo entonces se marca la tarea como entregada. Si la generación funciona pero falla el archivado, deben mantenerse estados separados para poder completar el guardado después, sin hacer creer al diseñador que el recurso ya está en la biblioteca. Es una propuesta de validación; aquí no se ha comprobado su funcionamiento real.
En un experimento interno que solo necesite una vista previa temporal, el equipo puede aceptar resultados de corta duración, pero aun así debe comunicar a los usuarios el límite de conservación. Cuando los recursos deban reutilizarse a largo plazo, hay que definir la ubicación de almacenamiento y quién se ocupará de los fallos antes de ampliar la integración. La función asíncrona de 4oImageApi.io ofrece una forma de gestionar por separado la espera y las notificaciones; el criterio de entrega del equipo debe ser un archivo que pueda seguir recuperando por sus propios medios.
Nota sobre el contenido:Este artículo se basa en información pública y sirve como referencia para comparar y elegir herramientas. Las funciones, los precios y las políticas relacionadas pueden cambiar en cualquier momento; consulta la información oficial más reciente.
Fuente original:docs.4oimageapi.io