核心指南
資料保留
關於請求詳細資訊與媒體內容的存取期限,以及如何保存重要結果的說明
請求與回應的詳細資訊,以及自動儲存的媒體結果,皆可保留 30 天。對話記錄、帳單記錄、已儲存的 Media Assets 以及您下載的檔案則另行處理。
請參閱 TokenLab 資料保留 以取得完整說明。
請求與回應詳細資訊
已儲存的請求與回應內容會在記錄後的 30 天內,於 Console、Request Debugger 和 TokenLab Agent (Assistant) 中提供存取。期限過後,這些工具將無法再檢索該原始內容。請求摘要、使用量與帳單記錄可能仍會保留。請務必在過期前下載您需要的任何詳細資訊。
過期的擷取內容與從未儲存或無法載入的內容不同。進行疑難排解時,請檢查顯示的狀態。
生成的媒體
TokenLab 會自動儲存支援的圖片、影片、音訊及可下載的 3D 結果(包含 Worlds 檔案)的副本,這些結果會以 HTTP(S) 連結形式回傳。您收到的每個媒體 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-protocol 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 | Token 或副檔名與結果不符 | 使用您收到的原始 URL |
410 media_expired | 30 天期限已過,或儲存失敗已超過 24 小時 | 該檔案已無法透過 TokenLab 存取 |
502 或 503 media_unavailable | 結果仍在記錄中,或 TokenLab 忙碌中 | 若有 Retry-After 延遲則依該時間重試,或稍候再試 |
對於圖片、影片與音訊結果,媒體結果 URL 會重新導向至最多持續五分鐘的下載 URL。若該連結在結果的 30 天視窗內過期,請再次請求該媒體結果 URL。這不會延長結果的過期時間。3D 檔案則直接從媒體結果 URL 本身進行串流傳輸。
TokenLab Agent (Assistant) 對話記錄
這些是您與內建 TokenLab 助理的對話。它們與 API 請求記錄分開儲存,且不會在請求記錄達到 30 天時自動刪除。對話中已儲存的文字可能會保留,但過期的請求詳細資訊與媒體無法再從該對話中載入。
您可以從 Agent 記錄中移除對話。這會將其從記錄列表中移除;但不會清除所有相關資料,也不會移除請求、帳單、支援或 Console 記錄。Assistant 僅能在 30 天視窗內調查原始請求與回應內容;較舊的帳單與使用量記錄可能仍可存取。
其他記錄與檔案
- 帳戶資訊、帳單與使用量記錄以及任務記錄會分開保存,以提供帳戶服務、帳單與支援。其保留期限不受 30 天請求詳細資訊視窗的限制。
- 組織通話記錄匯出檔案可供下載 90 天。請在過期前下載;匯出檔案的過期不會刪除底層記錄。
- 在 Console 或 TokenLab Agent (Assistant) 上傳的暫存檔案可在 24 小時內用於新請求。之後若需在新請求中使用,請重新上傳檔案。
- 您下載或匯出的檔案、瀏覽器儲存空間以及由您自己的應用程式儲存的副本皆由您自行控管。TokenLab 的保留限制不會刪除這些副本。
上述期限說明了透過 TokenLab 的可用性。從儲存空間刪除的時間可能會晚於存取期限。處理您請求的 AI 服務提供者擁有其各自的資料政策與保留期限。