Kernleitfäden
Datenaufbewahrung
Wie lange Sie auf Anfragedetails und Medien zugreifen können und wie Sie wichtige Ergebnisse speichern
Anfrage- und Antwortdetails sowie automatisch gespeicherte Medienergebnisse sind 30 Tage lang verfügbar. Gesprächsverläufe, Abrechnungsunterlagen, gespeicherte Media Assets und von Ihnen heruntergeladene Dateien werden separat behandelt.
Die vollständige Erläuterung finden Sie unter TokenLab Datenaufbewahrung.
Anfrage- und Antwortdetails
Gespeicherte Anfrage- und Antwortinhalte sind in der Console, im Request Debugger und im TokenLab Agent (Assistant) ab dem Zeitpunkt der Aufzeichnung 30 Tage lang verfügbar. Nach Ablauf dieser Frist können diese Tools den ursprünglichen Inhalt nicht mehr abrufen. Zusammenfassungen von Anfragen, Nutzungsdaten und Abrechnungsunterlagen können weiterhin verfügbar sein. Laden Sie alle benötigten Details herunter, bevor sie ablaufen.
Eine abgelaufene Erfassung unterscheidet sich von Inhalten, die nie gespeichert wurden oder nicht geladen werden konnten. Überprüfen Sie bei der Fehlerbehebung den angezeigten Status.
Generierte Medien
TokenLab speichert automatisch Kopien von unterstützten Bild-, Video-, Audio- und herunterladbaren 3D-Ergebnissen (einschließlich Worlds-Dateien), die als HTTP(S)-Links zurückgegeben werden. Jede Medien-URL, die Sie für diese Ergebnisse erhalten, ist eine TokenLab-URL: in API-Antworten, Aufgabenstatus-Abfragen, dem task.completed Webhook resultUrls sowie dem Seedance-kompatiblen Callback content.video_url und content.last_frame_url.
https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…Die Dateiendung entspricht dem Medientyp, zum Beispiel png, mp4, mp3 oder glb. Die URL bleibt ab dem Zeitpunkt der ersten Aufzeichnung des Ergebnisses 30 Tage lang gültig. Ein erneutes Aufrufen, ein erneuter Versuch oder das Überprüfen des Aufgabenstatus verlängert diesen Zeitraum nicht.
Die URL funktioniert, sobald Sie sie erhalten. Während TokenLab noch eine Kopie speichert, streamt die URL die Datei von der Quelle über TokenLab. Sobald die Kopie bereit ist, stellt die URL die Kopie bereit. Wenn das Speichern fehlschlägt, streamt die URL bis zu 24 Stunden nach Erstellung des Ergebnisses von der Quelle und gibt danach den HTTP-Status 410 zurück.
Für einen längeren Zugriff laden Sie die Datei herunter oder speichern Sie sie in den Media Assets, solange sie verfügbar ist. Eine in den Media Assets gespeicherte Kopie unterliegt nicht der automatischen 30-Tage-Löschfrist.
Die automatische Speicherung umfasst keine interaktiven Worlds-Seiten, extern referenzierte Modellabhängigkeiten, eingebettete Base64- oder Binärmedien, Eingabedateien oder Links innerhalb von generiertem Text. Speichern Sie diese Ergebnisse selbst, falls Sie sie später benötigen. Aufgabenprotokolle haben eine separate Lebensdauer; eine abgeschlossene Aufgabe garantiert nicht, dass ihre Medien weiterhin verfügbar sind.
Überprüfung der Medienverfügbarkeit über die API
KI-Protokoll-JSON-Antworten enthalten media_retention für unterstützte Ergebnisse: days und items, wobei jedes Element url, kind, status (saved, saving, failed oder expired), expires_at und, falls bekannt, content_type meldet. Wenn der Speicherstatus innerhalb des Antwortzeitlimits nicht bekannt ist, lässt die Antwort media_retention weg; die Medien-URL funktioniert weiterhin. Sie können auch metadata=true an eine Media-Result-URL anhängen, um deren aktuellen Status zu überprüfen. Dies gibt status, expires_at, content_type und kind zurück. Ein saving- oder failed-Status bedeutet nicht, dass die Datei gespeichert wurde.
Fehlgeschlagene und laufende Aufgaben geben leere Medien-URL-Felder zurück.
| Media-result URL Antwort | Bedeutung | Maßnahme |
|---|---|---|
404 media_not_found | Das Token oder die Dateiendung stimmt nicht mit dem Ergebnis überein | Verwenden Sie die exakte URL, die Sie erhalten haben |
410 media_expired | Der 30-Tage-Zeitraum ist abgelaufen oder das Speichern ist vor mehr als 24 Stunden fehlgeschlagen | Die Datei ist über TokenLab nicht mehr verfügbar |
502 oder 503 media_unavailable | Das Ergebnis wird noch aufgezeichnet oder TokenLab ist ausgelastet | Versuchen Sie es nach der Retry-After-Verzögerung (falls vorhanden) oder nach einer kurzen Wartezeit erneut |
Bei Bild-, Video- und Audioergebnissen leitet die Media-Result-URL auf eine Download-URL um, die maximal fünf Minuten gültig ist. Wenn dieser Link abläuft, während sich das Ergebnis noch innerhalb des 30-Tage-Fensters befindet, fordern Sie die Media-Result-URL erneut an. Dies verlängert nicht das Ablaufdatum des Ergebnisses. 3D-Dateien werden direkt von der Media-Result-URL gestreamt.
TokenLab Agent (Assistant) Gesprächsverlauf
Dies sind Ihre Unterhaltungen mit dem integrierten TokenLab-Assistenten. Sie werden getrennt von den API-Anfrageprotokollen gespeichert und nicht automatisch gelöscht, wenn diese Protokolle die 30-Tage-Grenze erreichen. Text, der bereits in einem Gespräch gespeichert wurde, kann dort verbleiben, aber abgelaufene Anfragedetails und Medien können aus diesem Gespräch nicht erneut geladen werden.
Sie können ein Gespräch aus dem Agent-Verlauf entfernen. Dies entfernt es aus der Verlaufsliste; es löscht jedoch nicht alle zugehörigen Daten und entfernt keine Anfrage-, Abrechnungs-, Support- oder Console-Verläufe. Der Assistant kann ursprüngliche Anfrage- und Antwortinhalte nur untersuchen, solange sie sich innerhalb des 30-Tage-Fensters befinden; ältere Abrechnungs- und Nutzungsdaten können weiterhin verfügbar sein.
Sonstige Aufzeichnungen und Dateien
- Kontoinformationen, Abrechnungs- und Nutzungshistorie sowie Aufgabenprotokolle werden separat aufbewahrt, um Kontodienste, Abrechnung und Support bereitzustellen. Ihre Aufbewahrung ist nicht auf das 30-Tage-Fenster für Anfragedetails beschränkt.
- Exportdateien von Anrufprotokollen der Organisation stehen 90 Tage lang zum Download bereit. Laden Sie diese herunter, bevor sie ablaufen; das Ablaufen eines Exports löscht nicht die zugrunde liegenden Datensätze.
- Temporäre Dateien, die in der Console oder im TokenLab Agent (Assistant) hochgeladen wurden, können 24 Stunden lang für neue Anfragen verwendet werden. Laden Sie die Datei danach erneut hoch, wenn Sie sie für eine neue Anfrage benötigen.
- Dateien, die Sie herunterladen oder exportieren, Browserspeicher und Kopien, die von Ihrer eigenen Anwendung gespeichert wurden, unterliegen Ihrer Kontrolle. Die Aufbewahrungsfristen von TokenLab löschen diese Kopien nicht.
Die oben genannten Zeiträume beschreiben die Verfügbarkeit über TokenLab. Die Löschung aus dem Speicher kann später erfolgen als der Ablauf des Zugriffs. KI-Dienstanbieter, die Ihre Anfragen verarbeiten, haben ihre eigenen Datenrichtlinien und Aufbewahrungsfristen.
Informationen zur Fehlerbehebung bei Anfragen finden Sie unter Logs und Fehlerbehebung. Informationen zum Abrufen von Medienaufgaben finden Sie unter Asynchrone Jobs und Polling.