الأدلة الأساسية
الاحتفاظ بالبيانات
المدة التي يمكنك خلالها الوصول إلى تفاصيل الطلبات والوسائط، وكيفية الاحتفاظ بالنتائج المهمة
تظل تفاصيل الطلبات والاستجابات، ونتائج الوسائط المحفوظة تلقائياً، متاحة لمدة 30 يوماً. يتم التعامل مع سجل المحادثات، وسجلات الفواتير، وMedia Assets المحفوظة، والملفات التي تقوم بتنزيلها بشكل منفصل.
راجع TokenLab data retention للحصول على الشرح الكامل.
تفاصيل الطلبات والاستجابات
يتم حفظ محتوى الطلبات والاستجابات في Console وRequest Debugger وTokenLab Agent (Assistant) لمدة 30 يوماً من تاريخ تسجيلها. بعد انتهاء هذه المدة، لا يمكن لهذه الأدوات استرداد ذلك المحتوى الأصلي. قد تظل ملخصات الطلبات، وبيانات الاستخدام، وسجلات الفواتير متاحة. قم بتنزيل أي تفاصيل تحتاجها قبل انتهاء صلاحيتها.
يختلف الالتقاط منتهي الصلاحية عن المحتوى الذي لم يتم حفظه أو الذي تعذر تحميله. تحقق من الحالة المعروضة عند استكشاف الأخطاء وإصلاحها.
الوسائط المُنشأة
يقوم TokenLab تلقائياً بحفظ نسخ من الصور، ومقاطع الفيديو، والملفات الصوتية، ونتائج الملفات ثلاثية الأبعاد القابلة للتنزيل (بما في ذلك ملفات Worlds) التي يتم إرجاعها كروابط HTTP(S). كل رابط وسائط تتلقاه لهذه النتائج هو رابط خاص بـ TokenLab: في استجابات API، وقراءات حالة المهام، وresultUrls الخاصة بـ webhook task.completed، وcontent.video_url وcontent.last_frame_url المتوافقة مع Seedance.
https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…يتطابق الامتداد مع نوع الوسائط، على سبيل المثال png أو mp4 أو mp3 أو glb. يظل الرابط صالحاً لمدة 30 يوماً من تاريخ تسجيل النتيجة لأول مرة. عرض الرابط مرة أخرى، أو إعادة المحاولة، أو التحقق من حالة المهمة لا يؤدي إلى إعادة تشغيل تلك الفترة.
يعمل الرابط بمجرد استلامه. بينما لا يزال TokenLab يحفظ نسخته، يقوم الرابط ببث الملف من المصدر عبر TokenLab. عندما تصبح النسخة جاهزة، يقوم الرابط بخدمة النسخة. إذا فشل الحفظ، يقوم الرابط بالبث من المصدر لمدة تصل إلى 24 ساعة بعد إنشاء النتيجة، ثم يعيد رمز الخطأ HTTP 410.
للوصول لفترة أطول، قم بتنزيل الملف أو احفظه في Media Assets بينما لا يزال متاحاً. النسخة المحفوظة في Media Assets لا تنتهي صلاحيتها بانتهاء فترة الـ 30 يوماً الخاصة بالنسخة التلقائية.
لا يشمل الحفظ التلقائي صفحات Worlds التفاعلية، أو تبعيات النماذج المشار إليها خارجياً، أو وسائط Base64 أو الوسائط الثنائية المضمنة، أو ملفات الإدخال، أو الروابط الموجودة داخل النصوص المُنشأة. احفظ هذه النتائج بنفسك إذا كنت بحاجة إليها لاحقاً. لسجلات المهام عمر افتراضي منفصل؛ فإكمال المهمة لا يضمن بقاء وسائطها متاحة.
التحقق من توفر الوسائط عبر API
تتضمن استجابات JSON الخاصة بـ AI-protocol حقل media_retention للنتائج المدعومة: days وitems، حيث يبلغ كل عنصر عن url وkind وstatus (saved أو saving أو failed أو expired) وexpires_at، وعند معرفته، content_type. إذا لم تكن حالة الحفظ معروفة ضمن الحد الزمني للاستجابة، فإن الاستجابة تغفل media_retention؛ ومع ذلك يظل رابط الوسائط يعمل. يمكنك أيضاً إضافة metadata=true إلى رابط media-result للتحقق من حالته الحالية. حيث يعيد status وexpires_at وcontent_type وkind. حالة saving أو الفشل لا تعني أنه تم حفظ الملف.
تعيد المهام الفاشلة والتي لا تزال قيد التنفيذ حقول روابط وسائط فارغة.
| استجابة رابط Media-result | المعنى | ما يجب فعله |
|---|---|---|
404 media_not_found | الرمز أو امتداد الملف لا يتطابق مع النتيجة | استخدم الرابط الدقيق الذي تلقيته |
410 media_expired | انتهت فترة الـ 30 يوماً، أو فشل الحفظ منذ أكثر من 24 ساعة | الملف لم يعد متاحاً عبر TokenLab |
502 أو 503 media_unavailable | النتيجة لا تزال قيد التسجيل، أو أن TokenLab مشغول | أعد المحاولة بعد تأخير Retry-After إن وجد، أو بعد انتظار قصير |
بالنسبة لنتائج الصور والفيديو والصوت، يتم إعادة توجيه رابط media-result إلى رابط تنزيل يستمر لمدة خمس دقائق كحد أقصى. إذا انتهت صلاحية ذلك الرابط بينما لا تزال النتيجة ضمن نافذة الـ 30 يوماً الخاصة بها، اطلب رابط media-result مرة أخرى. هذا لا يمدد فترة صلاحية النتيجة. يتم بث الملفات ثلاثية الأبعاد من رابط media-result نفسه.
سجل محادثات TokenLab Agent (Assistant)
هذه هي محادثاتك مع مساعد TokenLab المدمج. يتم تخزينها بشكل منفصل عن سجلات طلبات API ولا يتم حذفها تلقائياً عند وصول تلك السجلات إلى 30 يوماً. قد يظل النص المحفوظ بالفعل في المحادثة موجوداً، ولكن لا يمكن تحميل تفاصيل الطلبات والوسائط منتهية الصلاحية مرة أخرى من تلك المحادثة.
يمكنك إزالة محادثة من سجل Agent. يؤدي هذا إلى إزالتها من قائمة السجل؛ ولا يؤدي ذلك إلى مسح جميع البيانات المرتبطة أو إزالة سجلات الطلبات أو الفواتير أو الدعم أو Console. يمكن للمساعد التحقيق في محتوى الطلب والاستجابة الأصلي فقط بينما يكون ضمن نافذة الـ 30 يوماً؛ قد تظل سجلات الفواتير والاستخدام الأقدم متاحة.
سجلات وملفات أخرى
- يتم الاحتفاظ بمعلومات الحساب، وسجل الفواتير والاستخدام، وسجلات المهام بشكل منفصل لتقديم خدمات الحساب، والفواتير، والدعم. لا يقتصر الاحتفاظ بها على نافذة تفاصيل الطلب البالغة 30 يوماً.
- ملفات تصدير سجلات المكالمات الخاصة بالمؤسسة متاحة للتنزيل لمدة 90 يوماً. قم بتنزيلها قبل انتهاء صلاحيتها؛ انتهاء صلاحية التصدير لا يحذف السجلات الأساسية.
- الملفات المؤقتة التي يتم تحميلها في Console أو TokenLab Agent (Assistant) يمكن استخدامها في طلبات جديدة لمدة 24 ساعة. بعد ذلك، قم بتحميل الملف مرة أخرى إذا كنت بحاجة لاستخدامه في طلب جديد.
- الملفات التي تقوم بتنزيلها أو تصديرها، وتخزين المتصفح، والنسخ التي يحفظها تطبيقك الخاص تقع تحت سيطرتك. حدود الاحتفاظ الخاصة بـ TokenLab لا تحذف تلك النسخ.
تصف الفترات المذكورة أعلاه التوفر عبر TokenLab. قد يكتمل الحذف من التخزين في وقت لاحق لانتهاء صلاحية الوصول. مزودو خدمات الذكاء الاصطناعي الذين يعالجون طلباتك لديهم سياسات بيانات وفترات احتفاظ خاصة بهم.
لاستكشاف أخطاء الطلبات وإصلاحها، راجع السجلات واستكشاف الأخطاء وإصلاحها. لاستطلاع مهام الوسائط، راجع المهام غير المتزامنة (Async jobs) والاستطلاع (Polling).