コアガイド
データ保持
リクエストの詳細やメディアへのアクセス可能期間、および重要な結果を保持する方法について
リクエストとレスポンスの詳細、および自動保存されたメディアの結果は30日間利用可能です。会話履歴、請求記録、保存されたMedia Assets、およびダウンロードしたファイルは個別に管理されます。
詳細については、TokenLabデータ保持の完全な説明を参照してください。
リクエストとレスポンスの詳細
保存されたリクエストおよびレスポンスのコンテンツは、記録されてから30日間、Console、Request Debugger、およびTokenLab Agent (Assistant)で利用可能です。期限が切れると、これらのツールから元のコンテンツを取得することはできなくなります。リクエストの概要、使用状況、および請求記録は引き続き利用可能な場合があります。必要な詳細は期限が切れる前にダウンロードしてください。
期限切れのキャプチャは、保存されなかったコンテンツや読み込めなかったコンテンツとは異なります。トラブルシューティングの際は、表示されるステータスを確認してください。
生成されたメディア
TokenLabは、HTTP(S)リンクとして返されるサポート対象の画像、動画、音声、およびダウンロード可能な3D結果(Worldsファイルを含む)のコピーを自動的に保存します。これらの結果に対して受け取るすべてのメディアURLはTokenLabのURLです。これには、APIレスポンス、タスクステータスの読み取り、task.completed Webhookの resultUrls、およびSeedance互換のコールバック content.video_url と content.last_frame_url が含まれます。
https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…拡張子はメディアタイプと一致します(例: png、mp4、mp3、glb)。URLは、結果が最初に記録されてから30日間有効です。再度表示したり、再試行したり、タスクステータスを確認したりしても、この期間が延長されることはありません。
URLは受け取った直後から機能します。TokenLabがコピーを保存している間、URLはソースからTokenLabを経由してファイルをストリーミングします。コピーの準備ができると、URLはコピーを提供します。保存に失敗した場合、URLは結果が作成されてから最大24時間ソースからストリーミングを行い、その後HTTP 410を返します。
より長くアクセスする必要がある場合は、利用可能な期間中にファイルをダウンロードするか、Media Assetsに保存してください。Media Assetsに保存されたコピーは、30日間の自動コピーの期限が切れても削除されません。
自動保存は、インタラクティブなWorldsページ、外部参照されたモデルの依存関係、インラインのBase64またはバイナリメディア、入力ファイル、または生成されたテキスト内のリンクには適用されません。これらが必要な場合は、ご自身で保存してください。タスク記録には個別の保持期間があります。タスクが完了したからといって、そのメディアが引き続き利用可能であるとは限りません。
APIを通じたメディアの可用性の確認
AIプロトコルのJSONレスポンスには、サポートされている結果に対する media_retention が含まれます。これには days と items があり、各アイテムは url、kind、status (saved、saving、failed、または expired)、expires_at、および判明している場合は content_type を報告します。レスポンスの制限時間内に保存ステータスが不明な場合、レスポンスから media_retention は省略されますが、メディアURLは引き続き機能します。また、メディア結果URLに metadata=true を追加して現在のステータスを確認することもできます。これにより status、expires_at、content_type、および kind が返されます。saving または failed ステータスは、ファイルが保存されたことを意味するものではありません。
失敗したタスクや進行中のタスクは、空のメディアURLフィールドを返します。
| メディア結果URLのレスポンス | 意味 | 対処法 |
|---|---|---|
404 media_not_found | トークンまたはファイル拡張子が結果と一致しません | 受け取ったURLをそのまま使用してください |
410 media_expired | 30日間の期間が終了したか、保存が24時間以上前に失敗しました | ファイルはTokenLabを通じて利用できません |
502 または 503 media_unavailable | 結果が記録中であるか、TokenLabが混雑しています | Retry-After 遅延がある場合はその時間経過後、または少し待ってから再試行してください |
画像、動画、および音声の結果については、メディア結果URLは最大5分間有効なダウンロードURLにリダイレクトされます。結果が30日間のウィンドウ内にあるにもかかわらずそのリンクの期限が切れた場合は、再度メディア結果URLをリクエストしてください。これによって結果の有効期限が延長されることはありません。3Dファイルはメディア結果URL自体からストリーミングされます。
TokenLab Agent (Assistant) の会話履歴
これらは、組み込みのTokenLabアシスタントとの会話です。これらはAPIリクエストログとは別に保存され、ログが30日経過しても自動的に削除されることはありません。会話内にすでに保存されているテキストはそのまま残る場合がありますが、期限切れのリクエスト詳細やメディアをその会話から再度読み込むことはできません。
Agentの履歴から会話を削除することができます。これにより履歴リストからは削除されますが、関連するすべてのデータが消去されたり、リクエスト、請求、サポート、またはConsoleの履歴が削除されたりするわけではありません。アシスタントは、元のリクエストとレスポンスのコンテンツが30日間のウィンドウ内にある場合にのみ調査可能です。古い請求および使用状況の記録は引き続き利用可能な場合があります。
その他の記録とファイル
- アカウント情報、請求および使用状況の履歴、タスク記録は、アカウントサービス、請求、およびサポートを提供するために個別に保持されます。これらの保持期間は、30日間のリクエスト詳細ウィンドウに限定されません。
- 組織の通話記録エクスポートファイルは、90日間ダウンロード可能です。期限が切れる前にダウンロードしてください。エクスポートの期限が切れても、元の記録が削除されるわけではありません。
- ConsoleまたはTokenLab Agent (Assistant)にアップロードされた一時ファイルは、24時間、新しいリクエストで使用できます。それ以降は、新しいリクエストで使用する必要がある場合に再度ファイルをアップロードしてください。
- ダウンロードまたはエクスポートしたファイル、ブラウザストレージ、および独自のアプリケーションによって保存されたコピーは、お客様の管理下にあります。TokenLabの保持制限によってこれらのコピーが削除されることはありません。
上記の期間は、TokenLabを通じた可用性を説明するものです。ストレージからの削除は、アクセス期限よりも後に行われる場合があります。リクエストを処理するAIサービスプロバイダーには、独自のデータポリシーと保持期間があります。
リクエストのトラブルシューティングについては、ログとトラブルシューティングを参照してください。メディアタスクのポーリングについては、非同期ジョブとポーリングを参照してください。