コアガイド
データ保持
リクエストの詳細やメディアへのアクセス可能期間、および重要な結果を保持する方法について
リクエストとレスポンスの詳細、および自動保存されたメディアの結果は30日間利用可能です。会話履歴、請求記録、保存されたMedia Assets、およびダウンロードしたファイルは個別に管理されます。
詳細については、TokenLab data retention を参照してください。
リクエストとレスポンスの詳細
保存されたリクエストとレスポンスのコンテンツは、記録されてから30日間、Console、Request Debugger、およびTokenLab Agent (Assistant) で利用可能です。期限が切れると、これらのツールから元のコンテンツを取得することはできなくなります。リクエストの概要、使用量、請求記録は引き続き利用可能な場合があります。必要な詳細は期限が切れる前にダウンロードしてください。
期限切れのキャプチャは、保存されなかった、または読み込めなかったコンテンツとは異なります。トラブルシューティングの際は、表示されるステータスを確認してください。
生成されたメディア
TokenLabは、HTTP(S)リンクとして返されるサポート対象の画像、動画、音声、ダウンロード可能な3D結果（Worldsファイルを含む）のコピーを自動的に保存します。正常に保存されたコピーは、結果が最初に記録されてから30日間利用可能です。再表示、再試行、またはタスクステータスの確認を行っても、この期間がリセットされることはありません。
結果の保存ステータスと有効期限を確認してください。保存が進行中または失敗した場合、コピーが利用可能になる前に元のリンクが機能しなくなる可能性があります。より長くアクセスする必要がある場合は、ファイルが利用可能なうちにダウンロードするか、Media Assetsに保存してください。Media Assetsに保存されたコピーは、30日間の自動コピー期限の影響を受けません。
自動保存は、Worldsのインタラクティブページ、モデルが参照する外部依存ファイル、インラインのBase64やバイナリメディア、入力ファイル、または生成されたテキスト内のリンクには適用されません。これらが必要な場合は、各自で保存してください。タスク記録には個別の保持期間があり、タスクが完了していてもメディアが利用可能であるとは限りません。
APIを通じたメディアの可用性の確認
AI-protocolのJSONレスポンスには、サポート対象の結果に対して media_retention が含まれます。これには days と items があり、各アイテムは url、kind、status、および expires_at を報告します。また、メディア結果のURLに metadata=true を追加して、現在のステータスを確認することもできます。saving または失敗のステータスは、ファイルが保存されたことを意味するものではありません。期限切れの結果URLはHTTP 410を返します。
利用可能な結果から取得したダウンロードURLは、最大5分間有効です。結果が30日間のウィンドウ内にあるにもかかわらずURLの期限が切れた場合は、新しいURLをリクエストしてください。これによって結果の有効期限が延長されることはありません。
TokenLab Agent (Assistant) の会話履歴
これらは、組み込みのTokenLabアシスタントとの会話です。これらはAPIリクエストログとは別に保存され、ログが30日を経過しても自動的に削除されることはありません。会話内にすでに保存されているテキストはそのまま残る場合がありますが、期限切れのリクエスト詳細やメディアをその会話から再度読み込むことはできません。
会話をAgent履歴から削除することは可能です。これにより履歴リストからは削除されますが、関連するすべてのデータが消去されたり、リクエスト、請求、サポート、またはConsoleの履歴が削除されたりするわけではありません。アシスタントは、リクエストとレスポンスの元のコンテンツが30日間のウィンドウ内にある場合にのみ調査可能です。それより古い請求や使用量の記録は引き続き利用可能な場合があります。
その他の記録とファイル
- アカウント情報、請求および使用履歴、タスク記録は、アカウントサービス、請求、サポートを提供するために個別に保持されます。これらの保持期間は、30日間のリクエスト詳細ウィンドウに限定されません。
- 組織の通話記録エクスポートファイルは、90日間ダウンロード可能です。期限が切れる前にダウンロードしてください。エクスポートの期限が切れても、基となる記録が削除されるわけではありません。
- ConsoleまたはTokenLab Agent (Assistant) にアップロードされた一時ファイルは、24時間、新しいリクエストで使用できます。それ以降は、新しいリクエストで使用する必要がある場合に再度ファイルをアップロードしてください。
- ダウンロードまたはエクスポートしたファイル、ブラウザストレージ、および自身のアプリケーションによって保存されたコピーは、ユーザーの管理下にあります。TokenLabの保持制限によってこれらのコピーが削除されることはありません。
上記の期間は、TokenLabを通じた可用性を説明するものです。ストレージからの削除は、アクセス期限よりも遅れて完了する場合があります。リクエストを処理するAIサービスプロバイダーには、独自のデータポリシーと保持期間があります。
リクエストのトラブルシューティングについては、可観測性とトラブルシューティング を参照してください。メディアタスクのポーリングについては、非同期ジョブとポーリング を参照してください。