GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
すべてのガイド

· reAPI Team

APIデータの保持:リンクの期限が切れる前に出力を保存

生成ファイル、入力アップロード、バックアップのAPIデータ保持を計画します。リンクの期限が切れる前に出力を保存し、コピーを検証して、削除によって何が消去されるか確認しましょう。

APIデータの保持:リンクの期限が切れる前に出力を保存

動画の生成は正常に完了しました。データベースにはタスクIDとダウンロードURLがあります。これで結果がどこにあったかは分かりますが、動画のアーカイブにはなりません。

Replicateが文書で示すデフォルト設定により、この違いは重要です。API予測の入力、出力値、出力ファイル、ログは1時間後に削除されます。同社ウェブサイトで作成された予測には別のルールが適用され、手動で削除されるまで残ります。[1] ウェブセッションでまだ見えるファイルが、APIの結果をいつまでダウンロードできるかを示すわけではありません。

後で必要になる出力については、完了時のワークフローで実際のバイトデータを自分が管理するストレージにコピーし、そのコピーを検証する必要があります。削除時には、プロバイダー側のファイルと自分で作成したコピーの両方を考慮します。1つのファイルをこの手順に沿って追うと、保持に関する疑問が具体的になります。

ダウンロードに独立した完了状態を設ける

生成された動画を例に考えてみましょう。生成が完了し、アーカイブ用ワーカーが出力のコピーを開始します。「生成完了」と「コピー検証済み」は別々に管理してください。ダウンロードに失敗しても、前者は真で後者は偽のままという状態があり得ます。

完了したタスクについて文書化されている出力フィールドを読み、保持する各ファイルを特定します。複数の出力があるタスクでは、出力インデックスまたは同等の識別情報をタスクIDと一緒に保存します。単一の成功フラグでは、複数のファイルのうちどれがコピーされたか分かりません。

アプリケーションで認可されたアクセス経路からダウンロードし、保存先オブジェクトを書き込み、永続的に保存済みとして表示する前に確認します。保存先オブジェクトが存在し、転送が完了していて、そのサイズとメディアタイプに問題がないことを確かめます。可能であれば、自分のコピーを開くかデコードします。チェックサムはダウンロードしたバイトとの整合性を検証できますが、生成された場面が正しいことや、動画が顧客の依頼を満たすことまでは証明しません。

元のURL、タスクID、出力識別情報、保存先オブジェクトキー、コピー時刻を一緒に保持します。後でアプリケーションからアクセスするときは、自分のオブジェクト識別情報を使います。別のデータベース列に一時的なプロバイダーURLを保存しても、独立したコピーは作成されません。

同じ完了通知が再び届いた場合は、タスクと出力の識別情報を使い、すでに検証済みのコピーを認識します。必要に応じて未完了の転送を再試行しますが、通知が重複したというだけで説明のつかない重複ファイルを作らないようにします。これは提案するアプリケーションのワークフローであり、すべてのプロバイダーが代わりにアーカイブを実装しているという主張ではありません。

モデルの生成成功後にワーカーが失敗することもある

動画の例で、生成完了時にアーカイブ用ワーカーが利用できないとします。コピーは保留状態のままにします。ワーカーが復旧したら、ソースがまだ利用可能な間に取得を試みられます。ソースの期限が切れていた場合は、タスクを黙ってアーカイブ済みにせず、保存に失敗したことを記録します。

動画を再生成して、元ファイルを復旧したと説明してはいけません。再生成は別の処理であり、異なる内容になる可能性があり、追加料金が発生することもあります。まず、検証済みのコピーがすでにあるか、プロバイダーが文書化している別の取得経路があるかを確認します。たとえばfalは、期限切れのCDNファイルは完全に削除され、復元できないと説明しています。[2]

したがって、コピー処理の設計では保持期間を考慮する必要があります。適用される期間内にアプリケーションが確実にアーカイブできないなら、ワークフローを変更するか、後でアクセスできると約束する前に、文書化されたストレージを用意します。ある観察でリンクがたまたま長く使えたとしても、それは保存の保証ではありません。

reAPIのタスクに関するドキュメントも、長期アーカイブのため生成出力を速やかにコピーするよう案内しています。再ホストされたCDN出力について説明し、ライフサイクルポリシーはデプロイごとに設定され、この契約で保証されるものではないと述べています。[3] これは自分のコピーを保存する根拠になりますが、返されたすべてのURLに固定の期限があることや、永久にホストされることを示すものではありません。

復旧確認では、認可された合成アセットを使い、元のプロバイダーリンクに頼らず保存先のコピーを読み取ります。その確認結果を残してください。アップロード成功の報告だけより、アプリケーションが自分のオブジェクトを取得して利用できると確認する方が有用です。

リクエスト記録とメディアファイルの保持期間は異なることがある

サービスのルールによっては、例の動画ファイルが利用できなくなった後も、そのタスクは表示され続けることがあります。反対に、リクエスト内容を削除しても、すべてのメディアオブジェクトが削除されるとは限りません。保持期間を決める前に、対象となるオブジェクトを特定してください。

falの文書によると、デフォルトではリクエスト履歴の入力と出力は90日間保持されます。CDNファイルには別途、設定可能な保持期間があります。X-Fal-Store-IO: 0はリクエスト履歴のペイロード保存を制御し、X-Fal-Object-Lifecycle-Preferenceはメディアのライフサイクルを制御します。リクエストごとの設定はアカウントのデフォルトより優先されます。[2] 履歴の設定だけでは、すべての保存が無効になるわけではありません。

入力をアップロードすると、さらに別のオブジェクトが加わります。動画生成にプロバイダー側のコピーを使う間も、元の画像は自分のバケットに残っている場合があります。後で削除する必要があるなら、それらのコピー間の関係を保持してください。出力動画の保持期間から、参照画像の保持期間を判断することはできません。

コレクションや共有ビューも別の層です。falによると、Assetsを有効にすること、ファイルをコレクションに入れること、コレクションを共有することは、基となるファイルの保持期間を延長しません。[4] 保存されたライブラリ上の関連付けが、参照先のメディアを利用できる期間より長く残ることがあります。

同じ考え方はドキュメントのワークフローにも当てはまります。再利用可能なPDF注釈には、ファイルへの参照だけでなく抽出された内容が含まれることがあります。アプリケーションがそれを保存するなら、元の文書と合わせて、そのコピーも保持に関する判断に含めてください。

ライブラリ項目の削除はファイルの削除と同じではない

動画が自分のバケットにアーカイブされ、プロバイダー側のバージョンを削除したいとします。その目的に合った操作を選びます。ライブラリで非表示にすること、コレクションからメンバーシップを外すこと、CDNファイルを削除することは、それぞれ異なる操作です。

falのAssetsドキュメントによると、アセットを削除するとライブラリと検索結果からは消えますが、それだけでは基となるCDNファイルは削除されません。コレクションからの削除はさらに限定的で、アセットはライブラリや他のコレクションに残る場合があります。[4] 削除後にコレクションだけを確認しても、検証できるのは表示内容であり、ファイルが削除されたかどうかではありません。

完了した生成リクエストについて、falは別途リクエストペイロード削除操作を文書化しており、この操作はCDN出力ファイルも対象にします。CDN入力ファイルは他のリクエストで再利用される場合があるため、削除されません。[2] 参照画像も削除する必要がある場合は、他の場所での利用目的を確認してから、適切なファイル操作で処理してください。

ファイル単位で結果を確認します。falの削除レスポンスにはcdn_delete_resultsが含まれ、各ファイルの対象リンクとexception値が示されます。該当項目がnullなら、その削除は成功しています。[5] 全体のレスポンスが返っていても、複数の出力のうち1つについて報告された例外を無視してはいけません。

操作時刻、対象、未解決の失敗を記録します。その後ダウンロードに失敗したとしても、それはその取得経路に関する証拠であり、内部バックアップや下流のコピーがすべて消えたことを証明するものではありません。削除についての説明は、文書化された操作の範囲と実際に確認した結果に限定してください。

ReplicateのウェブサイトにあるDelete操作は、別途その対象範囲が文書化されています。予測と、関連する出力データおよびファイルを削除します。[1] 作成経路に応じたルールを使い、すべてのダッシュボードの削除ボタンがfalのライブラリ操作と同じだと決めつけないでください。

エクスポートやバックアップまでコピーを追跡する

プロバイダー側のバージョンを削除しても、自分のバケットにある動画は削除されません。顧客がエクスポートをダウンロードしたなら、それも別のコピーです。共有リンクを無効にすればそのリンク経由のアクセスは止まりますが、受信者がすでにダウンロードしたファイルは回収できません。falの共有ガイダンスは、この結果の違いを明示しています。[4]

自分で管理するコピーには、タスクと出力の識別情報、所有者、保存場所、削除ルールをオブジェクトとともに保持してください。そうすれば、後で削除リクエストを受けた際に、一時的なURLや名前のないエクスポートファイルに頼らず対応できます。ワークフローで作成される生成プレビュー、保存バージョン、移行時のコピーも含めてください。

バックアップについても明確に決める必要があります。意図した復旧目的のために保持し、復元したデータを後の削除とどのように整合させるかを考慮してください。そうしないと、古いバックアップの復元によって、アプリケーションがすでに削除した内容が再び取り込まれる可能性があります。ストレージを移行する際は、参照先を切り替える前に移行先を検証し、所有権と保持に関する判断をデータとともに引き継ぎます。

元ファイル、プレビュー、バックアップも移行先のストレージを使用します。ストレージ費用を見積もる際は、コピー数と各コピーの保持期間を含めてください。プロバイダー側のバージョンを削除しても、自分のアーカイブの費用はなくなりません。

ここで扱う生成出力の契約には、普遍的に適用される7年間の保持要件はありません。記録の種類によって要件は異なります。請求書に適用する期間を、すべての生成動画の保持期間に自動的に適用してはいけません。なじみのある年数を選ぶのではなく、対象オブジェクトと目的に応じたポリシーを定めてください。

データはどこに保存されるのでしょうか。この例では、プロバイダーのリクエスト履歴、CDNメディア、自分が所有するオブジェクト、エクスポート、バックアップに存在する可能性があります。地理的なデータ保管場所は別の契約上の問題です。メディアURLだけでは、すべてのコピーがどこで処理または保存されるかは分かりません。

ストレージ、共有、学習の問題を分けて考える

データを学習に使わないという説明は、データが一切保存されないことを意味しません。OpenAIのAPIデータガイドは、濫用監視ログとアプリケーションの状態を区別しています。Zero Data Retention(ZDR)制御は、対象となり承認された顧客が利用できますが、エンドポイントと機能の制限を受けます。[6] 実際の組織、プロジェクト、操作に適用される範囲を確認してください。

同様にfalは、リクエスト履歴とCDNの設定では、デプロイ所有者のアプリケーションログや、アプリケーションが管理する永続ストレージは設定されないと説明しています。ZDRを必要とするユーザーには、対象エンドポイントが含まれるか確認するよう求めています。[2] アプリケーション、ツール、自分のストレージも使うワークフローでは、1つのヘッダーですべてのコピーを説明することはできません。

この動画の例で、最終記録は2つの実務的な問いに答えられる必要があります。今後のダウンロードに使う検証済みコピーはどれか。ほかにどのコピーを削除し、どのコピーを明示したルールの下で保持しているか。転送失敗やファイル単位の削除例外は、解決するまで見える状態にしてください。そうすればアプリケーションは、生成完了、利用可能なアーカイブ、削除完了を、同じ事象であるかのように扱わず区別できます。

参考資料

  1. Replicate、「データ保持」、公式 predictions ドキュメント。2026年11月16日閲覧。APIのデフォルトとウェブサイトでの削除では対象範囲が異なります。
  2. fal、「データ保持とストレージ」、公式 Model APIs ドキュメント。2026年11月16日閲覧。リクエスト履歴、CDN、デプロイ所有者の責任はそれぞれ異なります。
  3. reAPI、タスクのドキュメント、出力形式とアーカイブに関する案内。2026年11月16日確認。
  4. fal、「保持と削除」、公式 Assets ドキュメント。2026年11月16日閲覧。ライブラリ操作、ファイルの保持期間、ダウンロード済みコピーについて。
  5. fal、「リクエストペイロードの削除」、公式 Platform APIリファレンス。2026年11月16日閲覧。ファイル単位の削除結果。本ガイドでは削除を実行していません。
  6. OpenAI、お客様のデータ。2026年11月16日閲覧。学習ポリシー、保持制御、エンドポイントの制限について。
すべてのガイド