4oImageApi.io ne conserve les images que 14 jours : la génération asynchrone doit aller jusqu’à l’archivage

Les équipes qui intègrent 4oImageApi.io à un backend de design doivent distinguer la réussite de la tâche de la livraison du visuel : suivre l’état via taskId et enregistrer les résultats, avant la fin des 14 jours de conservation, dans un stockage qu’elles gèrent elles-mêmes. Un callback peut signaler la fin du traitement, mais ne remplace pas l’archivage du fichier.

Source: docs.4oimageapi.io
20 novembre 2026
4 min

Une fois le backend de design connecté à 4oImageApi.io, peut-on clôturer la tâche dès réception de la notification de fin de génération ? Pas si l’image doit servir à une campagne le mois suivant. La documentation officielle indique que les images générées ne sont conservées que 14 jours. La génération asynchrone permet au backend de traiter séparément « envoyer la demande » et « récupérer le résultat », mais l’équipe doit ajouter une étape d’archivage sous sa responsabilité.

Cette analyse s’appuie sur la documentation pour examiner une tâche interne de création de visuel ; il ne s’agit pas d’un test réel de l’API. Supposons qu’un designer demande une image pour une campagne. Le livrable attendu du développeur est une image que l’on peut rouvrir dans sa propre bibliothèque de ressources, et pas seulement une tâche indiquée comme réussie sur le serveur.

Le callback signale la fin du traitement, la consultation de l’état aide à confirmer le résultat

La documentation précise qu’une notification POST est envoyée à l’URL de callback indiquée lorsque la tâche est terminée. Le point d’accès aux détails permet de consulter l’état de génération, les paramètres et les résultats à l’aide de taskId. Lors de l’intégration, il faut associer la demande de visuel à son taskId dans son propre suivi des tâches, afin de retrouver la demande d’origine lors des consultations ultérieures.

L’interface doit également distinguer « génération en cours » de « prêt à être vérifié par le designer ». Les états indiqués dans la documentation comprennent GENERATING, SUCCESS, CREATE_TASK_FAILED et GENERATE_FAILED. Après réception d’une notification, il faut vérifier l’état et le résultat pour décider s’il convient d’attendre encore, de traiter un échec ou de passer à l’inspection de l’image. Chaque notification ne doit pas être interprétée comme la réception d’un visuel exploitable.

En cas d’interrogation périodique, la documentation fixe un maximum de 3 consultations par seconde et par tâche. Il s’agit d’un plafond de consultation, pas d’une fréquence recommandée ni d’une promesse de générer 3 images par seconde. L’équipe doit régler l’intervalle en fonction de l’expérience d’attente souhaitée et arrêter les consultations répétées lorsque la tâche atteint un état final. Il ne faut pas confondre suivi de l’état et débit de génération d’images.

Les 14 jours de conservation font de l’archivage une partie de l’intégration

Pour une image destinée au mois suivant, noter uniquement l’URL du résultat fournie par le prestataire dans un tableau n’est pas une précaution suffisante. Puisque les images expirent après 14 jours, il faut enregistrer le résultat sélectionné avant l’expiration de ce délai, dans un stockage que l’on gère soi-même, puis reporter son emplacement interne dans le suivi de la tâche. Cette opération d’archivage relève de la solution d’intégration à mettre en place. La « prise en charge des callbacks » n’implique pas que le produit conservera les fichiers indéfiniment pour vous.

La validation peut porter sur la même demande : vérifier que le résultat s’ouvre, que l’image respecte les exigences du design et que la copie interne est lisible indépendamment, puis marquer la tâche comme livrée. Si la génération réussit mais que l’archivage échoue, il faut garder des états distincts pour pouvoir terminer l’enregistrement ensuite, plutôt que de laisser croire au designer que le visuel est déjà dans la bibliothèque. Il s’agit d’une proposition de validation ; son fonctionnement réel n’a pas été testé ici.

Pour une expérimentation interne qui ne nécessite qu’un aperçu temporaire, l’équipe peut accepter des résultats de courte durée, mais doit tout de même informer les utilisateurs de la limite de conservation. Dès que les visuels doivent être réutilisés à long terme, il faut définir l’emplacement de stockage et la responsabilité du traitement des échecs avant d’élargir l’intégration. La fonction asynchrone de 4oImageApi.io offre un moyen de traiter séparément l’attente et les notifications ; le critère de livraison de l’équipe doit toutefois être un fichier qu’elle peut continuer à récupérer elle-même.

À propos de cet article :Cet article s’appuie sur des informations publiques et sert de référence pour vous aider à choisir vos outils. Les fonctionnalités, les tarifs et les politiques associées peuvent évoluer à tout moment ; veuillez consulter les informations officielles les plus récentes.

Source originale :docs.4oimageapi.io