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

· reAPI Team

API-Datenspeicherung: Ausgaben sichern, bevor Links ablaufen

Plane die API-Datenspeicherung für generierte Dateien, Eingabe-Uploads und Sicherungen. Sichere Ausgaben, bevor Links ablaufen, überprüfe Kopien und prüfe, was beim Löschen entfernt wird.

API-Datenspeicherung: Ausgaben sichern, bevor Links ablaufen

Die Videogenerierung wurde erfolgreich abgeschlossen. Deine Datenbank enthält die Aufgaben-ID und eine Download-URL. Das zeigt, wo sich das Ergebnis befand, ist aber kein Archiv des Videos.

Die dokumentierte Standardeinstellung von Replicate macht diesen Unterschied dringend: API-Vorhersageeingaben, Ausgabewerte, Ausgabedateien und Protokolle werden nach einer Stunde entfernt. Vorhersagen, die auf der Website erstellt wurden, folgen einer anderen Regel und bleiben bis zur manuellen Löschung erhalten.[1] Eine Datei, die du in einer Websitzung noch sehen kannst, sagt nicht aus, wie lange ein API-Ergebnis heruntergeladen werden kann.

Für eine Ausgabe, die du später benötigst, sollte der Abschlussprozess die tatsächlichen Bytes in einen von dir kontrollierten Speicher kopieren und diese Kopie überprüfen. Beim Löschen musst du dann sowohl die Version des Anbieters als auch deine erstellten Kopien berücksichtigen. Verfolgst du eine Datei durch diese Schritte, werden die Fragen zur Aufbewahrung konkret.

Dem Download einen eigenen Abschlussstatus geben

Betrachte ein hypothetisch generiertes Video. Die Generierung ist abgeschlossen, und ein Archivierungs-Worker beginnt, die Ausgabe zu kopieren. Halte „Generierung abgeschlossen“ getrennt von „Kopie überprüft“. Schlägt der Download fehl, kann der erste Status wahr sein, während der zweite falsch bleibt.

Lies die dokumentierten Ausgabefelder der abgeschlossenen Aufgabe und bestimme jede Datei, die du aufbewahren willst. Bei einer Aufgabe mit mehreren Ausgaben speicherst du den Ausgabeindex oder eine gleichwertige Kennung zusammen mit der Aufgaben-ID. Ein einzelnes Erfolgskennzeichen zeigt nicht, welche von mehreren Dateien kopiert wurde.

Lade die Datei über den autorisierten Zugriffsweg deiner Anwendung herunter, schreibe das Zielobjekt und überprüfe es, bevor du es als dauerhaft gespeichert anzeigst. Bestätige, dass das erwartete Objekt vorhanden, die Übertragung abgeschlossen und Größe sowie Medientyp plausibel sind. Öffne oder dekodiere die eigene Kopie, sofern praktikabel. Eine Prüfsumme kann die Übereinstimmung mit den heruntergeladenen Bytes bestätigen; sie beweist nicht, dass die generierte Szene korrekt ist oder das Video dem Auftrag des Kunden entspricht.

Bewahre die ursprüngliche URL, Aufgaben-ID, Ausgabekennung, den Zielobjektschlüssel und den Kopierzeitpunkt gemeinsam auf. Verwende für den späteren Zugriff deiner Anwendung deine eigene Objektkennung. Die temporäre Anbieter-URL in einer weiteren Datenbankspalte zu speichern, erstellt keine unabhängige Kopie.

Trifft dieselbe Abschlussbenachrichtigung erneut ein, erkennst du anhand der Aufgaben- und Ausgabekennung eine bereits überprüfte Kopie. Wiederhole eine unvollständige Übertragung bei Bedarf, aber erzeuge nicht allein wegen einer wiederholten Benachrichtigung unerklärte Duplikate. Das ist ein vorgeschlagener Anwendungsablauf und keine Behauptung, dass jeder Anbieter dein Archiv für dich umsetzt.

Der Worker kann nach erfolgreichem Modelllauf ausfallen

Angenommen, im Videobeispiel ist der Archivierungs-Worker nicht verfügbar, wenn die Generierung abgeschlossen wird. Die Kopie sollte ausstehend bleiben. Sobald der Worker wieder verfügbar ist, kann er den Abruf versuchen, solange die Quelle noch verfügbar ist. Ist die Quelle abgelaufen, erfasse den Aufbewahrungsfehler, statt die Aufgabe stillschweigend als archiviert zu markieren.

Generiere das Video nicht erneut und bezeichne das als Wiederherstellung der Originaldatei. Eine weitere Generierung ist ein weiterer Vorgang, kann andere Inhalte erzeugen oder zusätzliche Kosten verursachen. Prüfe zuerst, ob bereits eine überprüfte Kopie oder ein anderer vom Anbieter dokumentierter Abrufweg vorhanden ist. fal erklärt beispielsweise, dass abgelaufene CDN-Dateien dauerhaft gelöscht werden und nicht wiederhergestellt werden können.[2]

Ein Aufbewahrungszeitraum ist daher ein Eingabewert für die Gestaltung des Kopierauftrags. Kann die Anwendung nicht zuverlässig innerhalb des geltenden Zeitraums archivieren, ändere den Ablauf oder richte dokumentierten Speicher ein, bevor du einen späteren Zugriff versprichst. Dass ein Link bei einer Beobachtung zufällig länger funktionierte, ist keine Speicherzusage.

Auch die Aufgabendokumentation von reAPI empfiehlt, generierte Ausgaben für eine langfristige Archivierung zeitnah zu kopieren. Sie beschreibt erneut gehostete CDN-Ausgaben und besagt, dass Lebenszyklusrichtlinien je Bereitstellung konfiguriert werden und durch diesen Vertrag nicht garantiert sind.[3] Das spricht dafür, eine eigene Kopie zu speichern; es belegt weder ein festes Ablaufdatum noch dauerhaftes Hosting für jede zurückgegebene URL.

Verwende für eine Wiederherstellungsprüfung ein autorisiertes synthetisches Asset und lies die Zielkopie aus, ohne dich auf den ursprünglichen Anbieterlink zu verlassen. Bewahre das Prüfergebnis auf. Eine erfolgreiche Uploadmeldung ist weniger hilfreich als die Bestätigung, dass die Anwendung das eigene Objekt abrufen und verwenden kann.

Ein Anfrageeintrag und eine Mediendatei können unterschiedlich lange bestehen

Je nach den Regeln des Dienstes kann die Aufgabe des hypothetischen Videos weiterhin sichtbar sein, während die Datei nicht mehr verfügbar ist. Umgekehrt muss das Entfernen von Anfrageinhalten nicht jedes Medienobjekt entfernen. Bestimme das Objekt, bevor du ihm eine Aufbewahrungsdauer zuweist.

fal dokumentiert, dass Anfrageeingaben und -ausgaben im Verlauf standardmäßig 90 Tage aufbewahrt werden. Für CDN-Dateien gilt eine separate, konfigurierbare Aufbewahrung. X-Fal-Store-IO: 0 steuert die Speicherung von Anfrageverlauf-Payloads; X-Fal-Object-Lifecycle-Preference steuert die Medienlebensdauer, wobei Einstellungen pro Anfrage den Kontostandards vorgehen.[2] Die Einstellung für den Verlauf allein schaltet nicht jede Speicherung ab.

Ein hochgeladenes Eingabeobjekt fügt ein weiteres Objekt hinzu. Dein Quellbild kann in deinem Bucket verbleiben, während eine Anbieterkopie zur Videogenerierung verwendet wird. Bewahre die Beziehung zwischen diesen Kopien auf, wenn sie später entfernt werden müssen. Die Lebensdauer des Ausgabevideos bestimmt nicht die des Referenzbilds.

Sammlungen und geteilte Ansichten bilden eine weitere Ebene. fal erklärt, dass das Aktivieren von Assets, das Ablegen einer Datei in einer Sammlung oder das Teilen dieser Sammlung die Lebensdauer der zugrunde liegenden Datei nicht verlängert.[4] Eine gespeicherte Bibliotheksbeziehung kann länger bestehen als das nutzbare Medium, auf das sie verweist.

Dasselbe gilt für Dokumentenabläufe. Wiederverwendbare PDF-Anmerkungen können extrahierte Inhalte statt bloßer Dateiverweise enthalten. Wenn deine Anwendung sie speichert, beziehe diese Kopie zusammen mit dem Originaldokument in die Aufbewahrungsentscheidungen ein.

Ein Bibliothekselement zu löschen ist nicht dasselbe wie die Datei zu löschen

Angenommen, das Video ist jetzt in deinem Bucket archiviert und du möchtest die anbieterseitige Version entfernen. Wähle den Vorgang, der zu diesem Ziel passt. Es sind unterschiedliche Aktionen, etwas in einer Bibliothek auszublenden, die Mitgliedschaft in einer Sammlung zu entfernen und die CDN-Datei zu löschen.

Die Assets-Dokumentation von fal besagt, dass das Löschen eines Assets es aus der Bibliothek und der Suche entfernt, aber nicht selbst die zugrunde liegende CDN-Datei löscht. Das Entfernen aus einer Sammlung ist noch enger gefasst: Das Asset kann in der Bibliothek und in anderen Sammlungen verbleiben.[4] Nur die Sammlung nach dem Entfernen zu prüfen, bestätigt die Ansicht, nicht die Löschung der Datei.

Für eine abgeschlossene Generierung dokumentiert fal einen separaten Vorgang zum Löschen des Anfrage-Payloads, der auch die CDN-Ausgabedateien betrifft. CDN-Eingabedateien werden nicht entfernt, da sie von anderen Anfragen wiederverwendet werden können.[2] Wenn auch das Referenzbild entfernt werden muss, prüfe zuerst seine beabsichtigte weitere Verwendung und bearbeite es dann mit dem passenden Dateivorgang.

Prüfe das Ergebnis auf Dateiebene. Die Löschantwort von fal enthält cdn_delete_results mit dem Ziellink und einem exception-Wert für jede Datei; null bedeutet für den jeweiligen Eintrag Erfolg.[5] Eine Gesamtantwort ist kein Grund, eine gemeldete Ausnahme für eine von mehreren Ausgaben zu ignorieren.

Erfasse den Zeitpunkt des Vorgangs, die Ziele und ungelöste Fehler. Ein späterer fehlgeschlagener Download ist ein Hinweis auf diesen Abrufweg, beweist aber nicht, dass alle internen Sicherungen oder nachgelagerten Kopien verschwunden sind. Beschränke die Aussage zur Löschung auf den dokumentierten Umfang des Vorgangs und die Ergebnisse, die du tatsächlich geprüft hast.

Die Delete-Aktion auf der Website von Replicate hat einen eigenen dokumentierten Umfang: Sie entfernt die Vorhersage sowie zugehörige Ausgabedaten und Dateien.[1] Verwende die Regel für den betreffenden Erstellungsweg, statt anzunehmen, dass sich jede Löschtaste in einem Dashboard wie die Bibliotheksaktion von fal verhält.

Verfolge die Kopie in Exporte und Sicherungen

Das Entfernen der Anbieterversion entfernt nicht das Video, das sich jetzt in deinem Bucket befindet. Wenn der Kunde einen Export heruntergeladen hat, ist das eine weitere Kopie. Einen Freigabelink zu widerrufen beendet den Zugriff über diesen Link, holt aber keine Dateien zurück, die Empfänger bereits heruntergeladen haben; die Freigabehinweise von fal unterscheiden diese Ergebnisse ausdrücklich.[4]

Bewahre bei den von dir kontrollierten Kopien die Aufgaben- und Ausgabekennung, den Eigentümer, den Speicherort und die Löschregel zusammen mit dem Objekt auf. So lässt sich eine spätere Löschanfrage bearbeiten, ohne auf eine temporäre URL oder einen unbeschrifteten Exportdateinamen angewiesen zu sein. Beziehe generierte Vorschauen, gespeicherte Versionen und Migrationskopien ein, wenn dein Ablauf sie erstellt.

Auch für Sicherungen ist eine ausdrückliche Entscheidung nötig. Bewahre sie für den vorgesehenen Wiederherstellungszweck auf und berücksichtige, wie wiederhergestellte Daten mit späteren Löschungen abgeglichen werden. Andernfalls kann das Wiederherstellen einer älteren Sicherung Inhalte zurückbringen, die die Anwendung bereits entfernt hatte. Prüfe bei einer Speichermigration das Ziel, bevor du Verweise umstellst, und übertrage die Entscheidung zu Eigentümerschaft und Aufbewahrung zusammen mit den Bytes.

Originale, Vorschauen und Sicherungen belegen ebenfalls deinen Zielspeicher. Berücksichtige bei der Kostenschätzung die Anzahl der Kopien und wie lange jede bestehen bleibt; das Löschen der Anbieterversion beseitigt nicht die Kosten deines eigenen Archivs.

In den hier besprochenen Verträgen für generierte Ausgaben gibt es keine allgemeingültige Aufbewahrungspflicht von sieben Jahren. Für verschiedene Datensatztypen können unterschiedliche Anforderungen gelten; eine für eine Rechnung angewandte Frist sollte nicht automatisch zur Lebensdauer jedes generierten Videos werden. Lege die geltende Richtlinie für das Objekt und den Zweck fest, statt eine vertraute Zahl auszuwählen.

Wo werden die Daten gespeichert? In diesem Beispiel kann es einen Anfrageverlauf beim Anbieter, CDN-Medien, dein eigenes Objekt, Exporte und Sicherungen geben. Der geografische Speicherort ist eine separate Vertragsfrage. Eine Medien-URL gibt nicht an, wo jede Kopie verarbeitet oder gespeichert wird.

Speicher-, Freigabe- und Trainingsfragen getrennt behandeln

Die Aussage, dass Daten nicht zum Training verwendet werden, bedeutet nicht, dass sie nie gespeichert werden. Der API-Datenleitfaden von OpenAI unterscheidet zwischen Protokollen zur Missbrauchsüberwachung und dem Anwendungszustand. Die Kontrollen für Zero Data Retention stehen berechtigten, genehmigten Kunden zur Verfügung und unterliegen weiterhin Einschränkungen bei Endpunkten und Funktionen.[6] Prüfe den Umfang, der für die tatsächliche Organisation, das Projekt und den Vorgang gilt.

Auch fal erklärt, dass seine Einstellungen für Anfrageverlauf und CDN weder die Anwendungsprotokollierung des Bereitstellungsinhabers noch den von der Anwendung verwalteten persistenten Speicher konfigurieren. Nutzer, die ZDR benötigen, sollen die Abdeckung der Endpunkte bestätigen.[2] Ein einzelner Header kann nicht jede Kopie in einem Ablauf beschreiben, der außerdem eine Anwendung, Tools und deinen eigenen Speicher nutzt.

Der abschließende Eintrag für das hypothetische Video sollte nun zwei praktische Fragen beantworten: Welche überprüfte Kopie dient künftigen Downloads, und welche anderen Kopien wurden entfernt oder bleiben nach einer festgelegten Regel bestehen? Lass einen fehlgeschlagenen Transfer oder eine dateibezogene Lösch-Ausnahme sichtbar, bis sie geklärt ist. So kann die Anwendung zwischen abgeschlossener Generierung, nutzbarem Archiv und abgeschlossener Löschung unterscheiden, ohne so zu tun, als wären sie dasselbe Ereignis.

Quellen

  1. Replicate, „Data retention“, offizielle Dokumentation zu predictions. Gelesen am 16. November 2026; API-Standardwerte und Löschung auf der Website haben unterschiedliche Geltungsbereiche.
  2. fal, „Data retention and storage“, offizielle Model-APIs-Dokumentation. Gelesen am 16. November 2026; Anfrageverlauf, CDN und Verantwortlichkeiten des Bereitstellungsinhabers sind getrennt.
  3. reAPI, Aufgabendokumentation, Ausgabeformat und Hinweise zur Archivierung. Geprüft am 16. November 2026.
  4. fal, „Retention and deletion“, offizielle Assets-Dokumentation. Gelesen am 16. November 2026; Bibliotheksaktionen, Dateilebensdauer und heruntergeladene Kopien.
  5. fal, „Delete request payloads“, offizielle Platform-API-Referenz. Gelesen am 16. November 2026; dateibezogene Löschresultate. Für diesen Leitfaden wurde keine Löschung durchgeführt.
  6. OpenAI, Deine Daten. Gelesen am 16. November 2026; Trainingsrichtlinie, Aufbewahrungskontrollen und Einschränkungen für Endpunkte.
Alle Anleitungen