Panduan inti

Retensi data

Berapa lama Anda dapat mengakses detail permintaan dan media, serta cara menyimpan hasil penting

Detail permintaan dan respons, serta hasil media yang disimpan secara otomatis, tersedia selama 30 hari. Riwayat percakapan, catatan penagihan, Media Assets yang disimpan, dan file yang Anda unduh ditangani secara terpisah.

Lihat Retensi data TokenLab untuk penjelasan lengkapnya.

Detail permintaan dan respons

Konten permintaan dan respons yang disimpan tersedia di Console, Request Debugger, dan TokenLab Agent (Assistant) selama 30 hari sejak direkam. Setelah kedaluwarsa, alat-alat ini tidak dapat lagi mengambil konten asli tersebut. Ringkasan permintaan, penggunaan, dan catatan penagihan mungkin masih tersedia. Unduh detail apa pun yang Anda perlukan sebelum masa berlakunya habis.

Hasil tangkapan yang kedaluwarsa berbeda dengan konten yang tidak pernah disimpan atau tidak dapat dimuat. Periksa status yang ditampilkan saat melakukan pemecahan masalah.

Media yang dihasilkan

TokenLab secara otomatis menyimpan salinan hasil gambar, video, audio, dan file 3D yang dapat diunduh (termasuk file Worlds) yang dikembalikan sebagai tautan HTTP(S). Setiap URL media yang Anda terima untuk hasil ini adalah URL TokenLab: dalam respons API, pembacaan status tugas, resultUrls pada webhook task.completed, serta content.video_url dan content.last_frame_url pada callback yang kompatibel dengan Seedance.

https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…

Ekstensi disesuaikan dengan jenis media, misalnya png, mp4, mp3, atau glb. URL tetap valid selama 30 hari sejak hasil pertama kali direkam. Melihatnya kembali, mencoba ulang, atau memeriksa status tugas tidak akan memulai ulang periode tersebut.

URL berfungsi segera setelah Anda menerimanya. Saat TokenLab masih menyimpan salinannya, URL akan melakukan streaming file dari sumber melalui TokenLab. Ketika salinan sudah siap, URL akan menyajikan salinan tersebut. Jika penyimpanan gagal, URL akan melakukan streaming dari sumber hingga 24 jam setelah hasil dibuat, kemudian mengembalikan HTTP 410.

Untuk akses yang lebih lama, unduh file atau simpan ke Media Assets selama file tersebut tersedia. Salinan yang disimpan ke Media Assets tidak akan kedaluwarsa bersamaan dengan salinan otomatis 30 hari.

Penyimpanan otomatis tidak mencakup halaman Worlds interaktif, dependensi model yang direferensikan secara eksternal, media Base64 atau biner inline, file input, atau tautan di dalam teks yang dihasilkan. Simpan hasil ini sendiri jika Anda membutuhkannya nanti. Catatan tugas memiliki masa pakai terpisah; tugas yang selesai tidak menjamin medianya masih tersedia.

Memeriksa ketersediaan media melalui API

Respons JSON AI-protocol menyertakan media_retention untuk hasil yang didukung: days dan items, dengan setiap item melaporkan url, kind, status (saved, saving, failed, atau expired), expires_at, dan, jika diketahui, content_type. Jika status penyimpanan tidak diketahui dalam batas waktu respons, respons akan menghilangkan media_retention; URL media tetap berfungsi. Anda juga dapat menambahkan metadata=true ke URL media-result untuk memeriksa statusnya saat ini. Ini akan mengembalikan status, expires_at, content_type, dan kind. Status saving atau gagal tidak berarti file telah disimpan.

Tugas yang gagal dan sedang berlangsung akan mengembalikan kolom URL media yang kosong.

Respons URL Media-resultArtiApa yang harus dilakukan
404 media_not_foundToken atau ekstensi file tidak cocok dengan hasilGunakan URL persis yang Anda terima
410 media_expiredPeriode 30 hari telah berakhir, atau penyimpanan gagal lebih dari 24 jam yang laluFile tidak lagi tersedia melalui TokenLab
502 atau 503 media_unavailableHasil masih direkam, atau TokenLab sedang sibukCoba lagi setelah jeda Retry-After jika ada, atau setelah menunggu sebentar

Untuk hasil gambar, video, dan audio, URL media-result akan mengalihkan ke URL unduhan yang bertahan paling lama lima menit. Jika tautan tersebut kedaluwarsa saat hasil masih dalam periode 30 hari, minta kembali URL media-result tersebut. Ini tidak memperpanjang masa kedaluwarsa hasil. File 3D melakukan streaming langsung dari URL media-result itu sendiri.

Riwayat percakapan TokenLab Agent (Assistant)

Ini adalah percakapan Anda dengan asisten TokenLab bawaan. Percakapan ini disimpan terpisah dari log permintaan API dan tidak dihapus secara otomatis saat log tersebut mencapai 30 hari. Teks yang sudah disimpan dalam percakapan mungkin tetap ada di sana, tetapi detail permintaan dan media yang kedaluwarsa tidak dapat dimuat kembali dari percakapan tersebut.

Anda dapat menghapus percakapan dari riwayat Agent. Ini akan menghapusnya dari daftar riwayat; tindakan ini tidak menghapus semua data terkait atau menghapus riwayat permintaan, penagihan, dukungan, atau Console. Assistant hanya dapat menyelidiki konten permintaan dan respons asli selama masih dalam periode 30 hari; catatan penagihan dan penggunaan yang lebih lama mungkin masih tersedia.

Catatan dan file lainnya

  • Informasi akun, riwayat penagihan dan penggunaan, serta catatan tugas disimpan secara terpisah untuk menyediakan layanan akun, penagihan, dan dukungan. Retensinya tidak dibatasi oleh jendela detail permintaan 30 hari.
  • File ekspor catatan panggilan organisasi tersedia untuk diunduh selama 90 hari. Unduh file tersebut sebelum kedaluwarsa; kedaluwarsa ekspor tidak menghapus catatan yang mendasarinya.
  • File sementara yang diunggah di Console atau TokenLab Agent (Assistant) dapat digunakan dalam permintaan baru selama 24 jam. Setelah itu, unggah kembali file tersebut jika Anda perlu menggunakannya dalam permintaan baru.
  • File yang Anda unduh atau ekspor, penyimpanan browser, dan salinan yang disimpan oleh aplikasi Anda sendiri berada di bawah kendali Anda. Batas retensi TokenLab tidak menghapus salinan tersebut.

Periode di atas menjelaskan ketersediaan melalui TokenLab. Penghapusan dari penyimpanan mungkin selesai lebih lambat dari kedaluwarsa akses. Penyedia layanan AI yang memproses permintaan Anda memiliki kebijakan data dan periode retensi mereka sendiri.

Untuk pemecahan masalah permintaan, lihat Log dan pemecahan masalah. Untuk polling tugas media, lihat Pekerjaan asinkron dan polling.

Di halaman ini