TokenLab

Guides essentiels

Rétention des données

Durée d'accès aux détails des requêtes et aux médias, et comment conserver les résultats importants

Les détails des requêtes et des réponses, ainsi que les résultats multimédias enregistrés automatiquement, sont disponibles pendant 30 jours. L'historique des conversations, les dossiers de facturation, les Media Assets enregistrés et les fichiers que vous téléchargez sont gérés séparément.

Consultez la rétention des données TokenLab pour une explication complète.

Détails des requêtes et des réponses

Le contenu enregistré des requêtes et des réponses est disponible dans la Console, le Request Debugger et TokenLab Agent (Assistant) pendant 30 jours à compter de leur enregistrement. Après expiration, ces outils ne peuvent plus récupérer ce contenu original. Les résumés des requêtes, l'utilisation et les dossiers de facturation peuvent rester disponibles. Téléchargez tous les détails dont vous avez besoin avant qu'ils n'expirent.

Une capture expirée est différente d'un contenu qui n'a jamais été enregistré ou qui n'a pas pu être chargé. Vérifiez le statut affiché lors du dépannage.

Médias générés

TokenLab enregistre automatiquement des copies des résultats pris en charge (images, vidéos, audio et fichiers 3D téléchargeables, y compris les fichiers Worlds) renvoyés sous forme de liens HTTP(S). Chaque URL multimédia que vous recevez pour ces résultats est une URL TokenLab : dans les réponses API, les lectures de statut de tâche, les resultUrls du webhook task.completed, et les champs content.video_url et content.last_frame_url du callback compatible Seedance.

https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…

L'extension correspond au type de média, par exemple png, mp4, mp3 ou glb. L'URL reste valide pendant 30 jours à compter de l'enregistrement initial du résultat. Le fait de la consulter à nouveau, de réessayer ou de vérifier le statut de la tâche ne relance pas cette période.

L'URL fonctionne dès que vous la recevez. Pendant que TokenLab enregistre sa copie, l'URL diffuse le fichier depuis la source via TokenLab. Lorsque la copie est prête, l'URL sert la copie. Si l'enregistrement échoue, l'URL diffuse le fichier depuis la source jusqu'à 24 heures après la création du résultat, puis renvoie une erreur HTTP 410.

Pour un accès plus long, téléchargez le fichier ou enregistrez-le dans Media Assets tant qu'il est disponible. Une copie enregistrée dans Media Assets n'expire pas avec la copie automatique de 30 jours.

L'enregistrement automatique ne couvre pas les pages interactives Worlds, les dépendances de modèles référencées en externe, les médias en ligne Base64 ou binaires, les fichiers d'entrée ou les liens au sein du texte généré. Enregistrez vous-même ces résultats si vous en avez besoin plus tard. Les enregistrements de tâches ont une durée de vie distincte ; une tâche terminée ne garantit pas que ses médias sont toujours disponibles.

Vérification de la disponibilité des médias via l'API

Les réponses JSON du protocole IA incluent media_retention pour les résultats pris en charge : days et items, chaque élément rapportant url, kind, status (saved, saving, failed ou expired), expires_at et, lorsqu'il est connu, content_type. Si le statut d'enregistrement n'est pas connu dans la limite de temps de réponse, la réponse omet media_retention ; l'URL multimédia fonctionne toujours. Vous pouvez également ajouter metadata=true à une URL de résultat multimédia pour vérifier son statut actuel. Elle renvoie status, expires_at, content_type et kind. Un statut saving ou failed ne signifie pas que le fichier a été enregistré.

Les tâches échouées ou en cours renvoient des champs d'URL multimédia vides.

Réponse de l'URL de résultat multimédiaSignificationQue faire
404 media_not_foundLe token ou l'extension de fichier ne correspond pas au résultatUtilisez l'URL exacte que vous avez reçue
410 media_expiredLa période de 30 jours est terminée, ou l'enregistrement a échoué il y a plus de 24 heuresLe fichier n'est plus disponible via TokenLab
502 ou 503 media_unavailableLe résultat est en cours d'enregistrement, ou TokenLab est occupéRéessayez après le délai Retry-After s'il est présent, ou après une courte attente

Pour les résultats d'image, de vidéo et d'audio, l'URL de résultat multimédia redirige vers une URL de téléchargement qui dure au maximum cinq minutes. Si ce lien expire alors que le résultat est toujours dans sa fenêtre de 30 jours, demandez à nouveau l'URL de résultat multimédia. Cela ne prolonge pas l'expiration du résultat. Les fichiers 3D sont diffusés directement depuis l'URL de résultat multimédia.

Historique des conversations TokenLab Agent (Assistant)

Il s'agit de vos conversations avec l'assistant TokenLab intégré. Elles sont stockées séparément des journaux de requêtes API et ne sont pas automatiquement supprimées lorsque ces journaux atteignent 30 jours. Le texte déjà enregistré dans une conversation peut y rester, mais les détails des requêtes et les médias expirés ne peuvent plus être chargés à partir de cette conversation.

Vous pouvez supprimer une conversation de l'historique de l'Agent. Cela la retire de la liste d'historique ; cela n'efface pas toutes les données associées et ne supprime pas l'historique des requêtes, de la facturation, du support ou de la Console. L'Assistant peut examiner le contenu original des requêtes et des réponses uniquement tant qu'il se trouve dans la fenêtre de 30 jours ; les anciens dossiers de facturation et d'utilisation peuvent rester disponibles.

Autres enregistrements et fichiers

  • Les informations de compte, l'historique de facturation et d'utilisation, ainsi que les enregistrements de tâches sont conservés séparément pour fournir les services de compte, la facturation et le support. Leur rétention n'est pas limitée à la fenêtre de 30 jours des détails de requête.
  • Les fichiers d'exportation des enregistrements d'appels de l'organisation sont disponibles au téléchargement pendant 90 jours. Téléchargez-les avant qu'ils n'expirent ; l'expiration d'une exportation ne supprime pas les enregistrements sous-jacents.
  • Les fichiers temporaires téléchargés dans la Console ou TokenLab Agent (Assistant) peuvent être utilisés dans de nouvelles requêtes pendant 24 heures. Après cela, téléchargez à nouveau le fichier si vous devez l'utiliser dans une nouvelle requête.
  • Les fichiers que vous téléchargez ou exportez, le stockage du navigateur et les copies enregistrées par votre propre application sont sous votre contrôle. Les limites de rétention de TokenLab ne suppriment pas ces copies.

Les périodes ci-dessus décrivent la disponibilité via TokenLab. La suppression du stockage peut se terminer plus tard que l'expiration de l'accès. Les fournisseurs de services d'IA qui traitent vos requêtes ont leurs propres politiques de données et périodes de rétention.

Pour le dépannage des requêtes, consultez Journaux et dépannage. Pour l'interrogation des tâches multimédias, consultez Tâches asynchrones et polling.

Sur cette page