GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Tous les guides

· reAPI Team

Conservation des données API : enregistre tes sorties avant l’expiration des liens

Planifie la conservation des données API pour les fichiers générés, les téléversements d’entrée et les sauvegardes. Enregistre les sorties avant l’expiration des liens, vérifie les copies et contrôle ce que la suppression retire.

Conservation des données API : enregistre tes sorties avant l’expiration des liens

La génération de la vidéo s’est terminée avec succès. Ta base de données contient l’ID de la tâche et une URL de téléchargement. Cela indique où se trouvait le résultat, mais ne constitue pas une archive de la vidéo.

La valeur par défaut documentée par Replicate rend cette distinction urgente : les entrées, les valeurs de sortie, les fichiers de sortie et les journaux des prédictions API sont supprimés au bout d’une heure. Les prédictions créées sur son site suivent une autre règle et restent jusqu’à leur suppression manuelle.[1] Le fait qu’un fichier soit encore visible dans une session Web ne permet pas de savoir combien de temps un résultat API restera téléchargeable.

Pour une sortie dont tu auras besoin plus tard, le processus de fin doit copier les octets réels dans un stockage que tu contrôles et vérifier cette copie. La suppression doit ensuite tenir compte de la version du fournisseur et des copies que tu as créées. Suis un fichier à travers ces étapes pour rendre concrètes les questions de conservation.

Attribue un état d’achèvement distinct au téléchargement

Imagine une vidéo générée. La génération est terminée et un worker d’archivage commence à copier la sortie. Distingue « génération terminée » de « copie vérifiée ». Si le téléchargement échoue, le premier état peut être vrai alors que le second reste faux.

Lis les champs de sortie documentés de la tâche terminée et identifie chaque fichier que tu veux conserver. Pour une tâche comportant plusieurs sorties, enregistre l’index de sortie ou un identifiant équivalent avec l’ID de la tâche. Un seul indicateur de réussite ne permet pas de savoir laquelle des sorties a été copiée.

Télécharge via le chemin d’accès autorisé de ton application, écris l’objet de destination et vérifie-le avant de le présenter comme sauvegardé durablement. Confirme que l’objet attendu existe, que le transfert est terminé et que sa taille et son type de média sont plausibles. Dans la mesure du possible, ouvre ou décode ta copie. Une somme de contrôle peut vérifier la cohérence avec les octets téléchargés ; elle ne prouve ni que la scène générée est correcte ni que la vidéo répond à la demande du client.

Conserve ensemble l’URL d’origine, l’ID de la tâche, l’identifiant de sortie, la clé de l’objet de destination et l’heure de la copie. Pour les accès ultérieurs de l’application, utilise ton propre identifiant d’objet. Enregistrer l’URL temporaire du fournisseur dans une autre colonne de base de données ne crée pas une copie indépendante.

Si la même notification d’achèvement arrive à nouveau, reconnais la copie déjà vérifiée à l’aide des identifiants de tâche et de sortie. Réessaie le transfert incomplet si nécessaire, mais évite de créer des doublons inexpliqués simplement parce que la notification a été répétée. Il s’agit d’un processus applicatif proposé, pas de l’affirmation que chaque fournisseur met ton archive en œuvre à ta place.

Le worker peut échouer après la réussite du modèle

Dans l’exemple de la vidéo, supposons que le worker d’archivage ne soit pas disponible lorsque la génération se termine. La copie doit rester en attente. À son retour, il peut tenter la récupération tant que la source est disponible. Si la source a expiré, enregistre l’échec de conservation au lieu de marquer silencieusement la tâche comme archivée.

Ne régénère pas la vidéo en présentant cela comme une récupération du fichier d’origine. Une nouvelle génération est une autre opération, peut produire un contenu différent ou entraîner des frais supplémentaires. Vérifie d’abord s’il existe une copie déjà vérifiée ou un autre moyen de récupération documenté par le fournisseur. Par exemple, fal indique que les fichiers CDN expirés sont définitivement supprimés et ne peuvent pas être récupérés.[2]

La durée de conservation est donc un paramètre de conception du travail de copie. Si l’application ne peut pas archiver de manière fiable dans le délai applicable, modifie le processus ou mets en place un stockage documenté avant de promettre un accès ultérieur. Le fait qu’un lien ait fonctionné plus longtemps lors d’une observation ne garantit pas le stockage.

La documentation des tâches de reAPI recommande également de copier rapidement les sorties générées pour leur archivage à long terme. Elle décrit des sorties CDN réhébergées et précise que les règles de cycle de vie sont configurées par déploiement et ne sont pas garanties par ce contrat.[3] Cela justifie de conserver ta propre copie, sans établir de date d’expiration fixe ni d’hébergement permanent pour chaque URL renvoyée.

Pour vérifier la récupération, utilise un actif synthétique autorisé et lis la copie de destination sans dépendre du lien du fournisseur d’origine. Conserve le résultat de cette vérification. Un téléversement signalé comme réussi est moins utile que la confirmation que l’application peut récupérer et utiliser l’objet que tu possèdes.

Un enregistrement de requête et un fichier média peuvent avoir des durées de vie différentes

Selon les règles du service, la tâche de la vidéo hypothétique peut rester visible alors que le fichier n’est plus disponible. À l’inverse, supprimer le contenu de la requête ne supprime pas nécessairement chaque objet média. Identifie l’objet avant de lui attribuer une durée de conservation.

fal indique que les entrées et sorties de l’historique des requêtes sont conservées 90 jours par défaut. Les fichiers CDN ont une conservation configurable distincte. X-Fal-Store-IO: 0 contrôle le stockage des charges utiles de l’historique des requêtes ; X-Fal-Object-Lifecycle-Preference contrôle la durée de vie des médias, les paramètres par requête ayant priorité sur les valeurs par défaut du compte.[2] Le paramètre d’historique ne désactive pas à lui seul tout stockage.

Un téléversement d’entrée ajoute un autre objet. Ton image source peut rester dans ton bucket tandis qu’une copie du fournisseur sert à générer la vidéo. Conserve le lien entre ces copies si elles doivent être supprimées ultérieurement. La durée de vie de la vidéo de sortie ne détermine pas celle de son image de référence.

Les collections et les vues partagées constituent une autre couche. fal indique que l’activation d’Assets, l’ajout d’un fichier à une collection ou le partage de cette collection ne prolonge pas la durée de vie du fichier sous-jacent.[4] Une association enregistrée dans la bibliothèque peut subsister après la période pendant laquelle le média pointé reste utilisable.

Le même raisonnement s’applique aux processus documentaires. Les annotations PDF réutilisables peuvent contenir du contenu extrait, et pas seulement des références à un fichier. Si ton application les stocke, inclus cette copie dans les décisions de conservation avec le document d’origine.

Supprimer l’élément de la bibliothèque ne supprime pas le fichier

Supposons que la vidéo soit maintenant archivée dans ton bucket et que tu veuilles retirer la version côté fournisseur. Choisis l’opération correspondant à cet objectif. Masquer un élément dans une bibliothèque, le retirer d’une collection et supprimer le fichier CDN sont des actions différentes.

La documentation Assets de fal indique que supprimer un asset le retire de la bibliothèque et des résultats de recherche, mais ne supprime pas à lui seul le fichier CDN sous-jacent. Le retrait d’une collection est encore plus limité : l’asset peut rester dans la bibliothèque et d’autres collections.[4] Vérifier uniquement la collection après le retrait permet de contrôler la vue, pas la suppression du fichier.

Pour une génération terminée, fal documente une opération distincte de suppression de la charge utile de la requête, qui cible aussi les fichiers de sortie CDN. Elle ne supprime pas les fichiers d’entrée CDN, qui peuvent être réutilisés par d’autres requêtes.[2] Si l’image de référence doit également être supprimée, vérifie d’abord son utilisation prévue ailleurs, puis traite-la avec l’opération de fichier appropriée.

Vérifie le résultat au niveau du fichier. La réponse de suppression de fal contient cdn_delete_results, avec le lien ciblé et une valeur exception pour chaque fichier ; null indique que la suppression de cette entrée a réussi.[5] Une réponse globale ne justifie pas d’ignorer une exception signalée pour l’une de plusieurs sorties.

Consigne l’heure de l’opération, les éléments ciblés et les échecs non résolus. Un échec de téléchargement ultérieur fournit un indice sur ce chemin de récupération, mais ne prouve pas que toutes les sauvegardes internes ou copies en aval ont disparu. Limite l’affirmation de suppression à la portée de l’opération documentée et aux résultats que tu as réellement vérifiés.

L’action Delete du site de Replicate a sa propre portée documentée : elle supprime la prédiction ainsi que les données et fichiers de sortie associés.[1] Applique la règle correspondant au chemin de création concerné au lieu de supposer que tous les boutons de suppression des tableaux de bord fonctionnent comme l’action de bibliothèque de fal.

Suis la copie jusque dans les exports et les sauvegardes

La suppression de la version du fournisseur ne supprime pas la vidéo désormais présente dans ton bucket. Si le client a téléchargé un export, il s’agit d’une autre copie. Révoquer un lien de partage arrête l’accès via ce lien, mais ne récupère pas les fichiers déjà téléchargés par les destinataires ; les conseils de partage de fal distinguent explicitement ces résultats.[4]

Pour les copies que tu contrôles, conserve avec l’objet l’identifiant de la tâche et de la sortie, le propriétaire, l’emplacement de stockage et la règle de suppression. Une demande de suppression ultérieure pourra ainsi être traitée sans dépendre d’une URL temporaire ou d’un nom de fichier d’export sans étiquette. Inclus les aperçus générés, les versions stockées et les copies de migration créées par ton processus.

Les sauvegardes nécessitent également une décision explicite. Conserve-les pour l’objectif de récupération prévu et détermine comment les données restaurées seront rapprochées des suppressions ultérieures. Sinon, la restauration d’une ancienne sauvegarde peut réintroduire du contenu que l’application avait déjà supprimé. Lors d’une migration de stockage, vérifie la destination avant de changer les références, puis transfère avec les données la décision concernant la propriété et la conservation.

Les originaux, aperçus et sauvegardes occupent eux aussi ton stockage de destination. Pour estimer ce coût, tiens compte du nombre de copies et de la durée de conservation de chacune ; supprimer la version du fournisseur n’élimine pas le coût de ta propre archive.

Les contrats relatifs aux sorties générées abordés ici n’imposent aucune durée universelle de conservation de sept ans. Les exigences peuvent varier selon le type d’enregistrement ; une période appliquée à une facture ne doit pas automatiquement devenir la durée de vie de chaque vidéo générée. Définis la politique applicable à l’objet et à son usage au lieu de choisir une durée familière.

Où les données sont-elles stockées ? Dans cet exemple, elles peuvent se trouver dans l’historique des requêtes du fournisseur, les médias CDN, ton objet, les exports et les sauvegardes. La résidence géographique constitue une question contractuelle distincte. Une URL média n’indique pas où chaque copie est traitée ou stockée.

Distingue les questions de stockage, de partage et d’entraînement

Dire que les données ne sont pas utilisées pour l’entraînement ne signifie pas qu’elles ne sont jamais stockées. Le guide d’OpenAI sur les données API distingue les journaux de surveillance des abus de l’état de l’application. Les contrôles Zero Data Retention sont accessibles aux clients éligibles et approuvés, et restent soumis à des limitations concernant les endpoints et les fonctionnalités.[6] Vérifie le périmètre applicable à l’organisation, au projet et à l’opération concernés.

fal précise également que ses paramètres d’historique des requêtes et de CDN ne configurent ni la journalisation de l’application du propriétaire du déploiement ni le stockage persistant géré par l’application. Les utilisateurs qui exigent le ZDR doivent confirmer la couverture des endpoints.[2] Un seul en-tête ne peut décrire toutes les copies d’un processus qui utilise aussi une application, des outils et ton propre stockage.

Pour cette vidéo hypothétique, l’enregistrement final doit maintenant répondre à deux questions pratiques : quelle copie vérifiée servira aux téléchargements futurs, et quelles autres copies ont été supprimées ou restent soumises à une règle indiquée ? Garde visibles les échecs de transfert et les exceptions de suppression par fichier jusqu’à leur résolution. L’application peut ainsi distinguer une génération terminée, une archive utilisable et une suppression achevée sans prétendre qu’il s’agit du même événement.

Références

  1. Replicate, « Data retention », documentation officielle des prédictions. Consultée le 16 novembre 2026 ; les règles par défaut de l’API et la suppression sur le site ont des périmètres différents.
  2. fal, « Data retention and storage », documentation officielle de Model APIs. Consultée le 16 novembre 2026 ; l’historique des requêtes, le CDN et les responsabilités du propriétaire du déploiement sont distincts.
  3. reAPI, documentation des tâches, format des sorties et conseils d’archivage. Vérifiée le 16 novembre 2026.
  4. fal, « Retention and deletion », documentation officielle d’Assets. Consultée le 16 novembre 2026 ; actions de bibliothèque, durée de vie des fichiers et copies téléchargées.
  5. fal, « Delete request payloads », référence officielle de Platform API. Consultée le 16 novembre 2026 ; résultats de suppression par fichier. Aucune suppression n’a été effectuée pour ce guide.
  6. OpenAI, Vos données. Consultée le 16 novembre 2026 ; politique d’entraînement, contrôles de conservation et limites des endpoints.
Tous les guides