Temel kılavuzlar

Veri saklama

İstek detaylarına ve medyaya ne kadar süreyle erişebileceğiniz ve önemli sonuçları nasıl saklayacağınız

İstek ve yanıt detayları ile otomatik olarak kaydedilen medya sonuçları 30 gün boyunca erişilebilir durumdadır. Konuşma geçmişi, faturalandırma kayıtları, kaydedilmiş Media Assets ve indirdiğiniz dosyalar ayrı olarak ele alınır.

Tam açıklama için TokenLab veri saklama sayfasına bakın.

İstek ve yanıt detayları

Kaydedilmiş istek ve yanıt içeriği; Console, Request Debugger ve TokenLab Agent (Assistant) içerisinde, kaydedildiği andan itibaren 30 gün boyunca kullanılabilir. Süre dolduktan sonra, bu araçlar artık orijinal içeriği geri getiremez. İstek özetleri, kullanım ve faturalandırma kayıtları hala erişilebilir olabilir. İhtiyacınız olan tüm detayları süreleri dolmadan önce indirin.

Süresi dolmuş bir kayıt, hiç kaydedilmemiş veya yüklenememiş içerikten farklıdır. Sorun giderme sırasında görüntülenen durumu kontrol edin.

Oluşturulan medya

TokenLab; HTTP(S) bağlantıları olarak döndürülen desteklenen görsel, video, ses ve indirilebilir 3D sonuçlarının (Worlds dosyaları dahil) kopyalarını otomatik olarak kaydeder. Bu sonuçlar için aldığınız her medya URL'si bir TokenLab URL'sidir: API yanıtlarında, görev durumu okumalarında, task.completed webhook resultUrls kısmında ve Seedance uyumlu geri çağırma (callback) content.video_url ve content.last_frame_url alanlarında bu geçerlidir.

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

Uzantı, medya türüyle eşleşir; örneğin png, mp4, mp3 veya glb. URL, sonucun ilk kaydedildiği andan itibaren 30 gün boyunca geçerli kalır. Tekrar görüntülemek, yeniden denemek veya görev durumunu kontrol etmek bu süreyi yeniden başlatmaz.

URL, aldığınız anda çalışır. TokenLab kopyasını kaydederken, URL dosyayı kaynaktan TokenLab aracılığıyla yayınlar (stream). Kopya hazır olduğunda, URL kopyayı sunar. Kaydetme başarısız olursa, URL sonuç oluşturulduktan sonra 24 saate kadar kaynaktan yayın yapmaya devam eder, ardından HTTP 410 döndürür.

Daha uzun süreli erişim için dosyayı indirin veya kullanılabilir durumdayken Media Assets kısmına kaydedin. Media Assets içine kaydedilen bir kopya, 30 günlük otomatik kopya ile birlikte silinmez.

Otomatik kaydetme; etkileşimli Worlds sayfalarını, harici olarak referans verilen model bağımlılıklarını, satır içi (inline) Base64 veya ikili (binary) medyayı, girdi dosyalarını veya oluşturulan metin içindeki bağlantıları kapsamaz. Daha sonra ihtiyacınız olacaksa bu sonuçları kendiniz kaydedin. Görev kayıtlarının ayrı bir ömrü vardır; tamamlanmış bir görev, medyasının hala mevcut olduğunu garanti etmez.

API aracılığıyla medya kullanılabilirliğini kontrol etme

AI-protocol JSON yanıtları, desteklenen sonuçlar için media_retention bilgisini içerir: days ve items. Her bir öğe; url, kind, status (saved, saving, failed veya expired), expires_at ve biliniyorsa content_type bilgilerini raporlar. Kaydetme durumu yanıt süresi sınırı içinde bilinmiyorsa, yanıt media_retention bilgisini içermez; medya URL'si yine de çalışır. Ayrıca mevcut durumunu kontrol etmek için bir medya sonucu URL'sine metadata=true ekleyebilirsiniz. Bu işlem status, expires_at, content_type ve kind bilgilerini döndürür. saving veya başarısız (failed) durumu, dosyanın kaydedildiği anlamına gelmez.

Başarısız ve devam eden görevler boş medya URL alanları döndürür.

Medya sonucu URL yanıtıAnlamıNe yapmalı
404 media_not_foundToken veya dosya uzantısı sonuçla eşleşmiyorAldığınız tam URL'yi kullanın
410 media_expired30 günlük süre doldu veya kaydetme 24 saatten uzun süre önce başarısız olduDosyaya artık TokenLab üzerinden erişilemez
502 veya 503 media_unavailableSonuç hala kaydediliyor veya TokenLab meşgulVarsa Retry-After gecikmesinden sonra veya kısa bir bekleyişten sonra tekrar deneyin

Görsel, video ve ses sonuçları için medya sonucu URL'si, en fazla beş dakika süren bir indirme URL'sine yönlendirir. Sonuç hala 30 günlük penceresi içindeyken bu bağlantının süresi dolarsa, medya sonucu URL'sini tekrar isteyin. Bu işlem sonucun son kullanma tarihini uzatmaz. 3D dosyalar doğrudan medya sonucu URL'sinden yayınlanır.

TokenLab Agent (Assistant) konuşma geçmişi

Bunlar, yerleşik TokenLab asistanı ile yaptığınız konuşmalardır. API istek günlüklerinden ayrı olarak saklanırlar ve bu günlükler 30 günü doldurduğunda otomatik olarak silinmezler. Bir konuşmada zaten kaydedilmiş metinler orada kalabilir, ancak süresi dolmuş istek detayları ve medya o konuşmadan tekrar yüklenemez.

Bir konuşmayı Agent geçmişinden kaldırabilirsiniz. Bu işlem onu geçmiş listesinden siler; ancak ilişkili tüm verileri silmez veya istek, faturalandırma, destek ya da Console geçmişini kaldırmaz. Assistant, orijinal istek ve yanıt içeriğini yalnızca 30 günlük pencere içindeyken inceleyebilir; daha eski faturalandırma ve kullanım kayıtları hala erişilebilir olabilir.

Diğer kayıtlar ve dosyalar

  • Hesap bilgileri, faturalandırma ve kullanım geçmişi ile görev kayıtları; hesap hizmetleri, faturalandırma ve destek sağlamak amacıyla ayrı olarak tutulur. Bunların saklanması 30 günlük istek detayı penceresiyle sınırlı değildir.
  • Organizasyon çağrı kaydı dışa aktarma (export) dosyaları 90 gün boyunca indirilebilir durumdadır. Süreleri dolmadan önce indirin; bir dışa aktarma dosyasının süresinin dolması, temel kayıtları silmez.
  • Console veya TokenLab Agent (Assistant) içine yüklenen geçici dosyalar, 24 saat boyunca yeni isteklerde kullanılabilir. Bu süreden sonra, yeni bir istekte kullanmanız gerekirse dosyayı tekrar yükleyin.
  • İndirdiğiniz veya dışa aktardığınız dosyalar, tarayıcı depolama alanı ve kendi uygulamanız tarafından kaydedilen kopyalar sizin kontrolünüzdedir. TokenLab'in saklama sınırları bu kopyaları silmez.

Yukarıdaki süreler, TokenLab üzerinden erişilebilirliği tanımlar. Depolamadan silme işlemi, erişim süresi dolduktan sonra gerçekleşebilir. İsteklerinizi işleyen yapay zeka hizmet sağlayıcılarının kendi veri politikaları ve saklama süreleri vardır.

İstek sorunlarını gidermek için Günlükler ve sorun giderme bölümüne bakın. Medya görevi yoklama (polling) işlemleri için Asenkron işler ve yoklama bölümüne bakın.

Bu sayfada