إنشاء أصل مادي (Material Asset)

قم باستيراد رابط مصدر متاح للجمهور إلى مجموعة مواد Seedance. يقوم TokenLab بتخزين المادة لاستخدامها لاحقاً؛ استخدم id الخاص بالأصل المادي الذي تم إرجاعه لعملية الإنشاء، وليس رابط المصدر.

بالنسبة لـ library_type: "aigc_avatar"، فإن group_id اختياري؛ حيث يستخدم TokenLab أو ينشئ مجموعة الصور الرمزية الافتراضية للمؤسسة. بالنسبة لـ library_type: "liveness_face"، فإن group_id مطلوب ويجب أن يكون مجموعة TokenLab التي تم إرجاعها بواسطة الحصول على نتيجة التحقق المرئي.

يتحقق TokenLab من رابط المصدر ونوع الوسائط وحجم الملف وأبعاد الصور القابلة للقراءة. قبول الاستيراد لا يعني أن الأصل جاهز: انتظر ACTIVE وافحص error_message عند فشل المعالجة. تُفحص شروط الوسائط والوجوه الأخرى أثناء المعالجة.

عملية الإنشاء غير متزامنة. قم بإجراء استعلام (Poll) لـ الحصول على أصل مادي (Material Asset) حتى تصبح status هي ACTIVE. بالنسبة لمجموعات الأشخاص الحقيقيين، ترتبط كل مجموعة بشخص واحد تم التحقق منه؛ قد تفشل عمليات التحميل التي تحتوي على وجوه متعددة أو وجه لا يطابق الشخص الذي تم التحقق منه.

يعزل project_name الموارد داخل المؤسسة المصادق عليها. قيمته الافتراضية default؛ استخدم القيمة نفسها مع مراعاة حالة الأحرف للمجموعات والأصول المرتبطة. أرسله في جسم JSON مع POST/PUT وفي معاملات الاستعلام مع GET/DELETE.

مثال على الطلبCopy Anchor Link

curl https://api.tokenlab.sh/v1/videos/assets \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'

مثال على الاستجابةCopy Anchor Link

{
  "id": "asset-20260720123456-qn7wr",
  "object": "seedance.material_asset",
  "project_name": "default",
  "group_id": "group-20260720123456-vrt01",
  "library_type": "aigc_avatar",
  "asset_name": "Front view",
  "asset_type": "Image",
  "status": "PROCESSING",
  "ready": false,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000
}

curl -X POST "https://example.com/v1/videos/assets" \  -H "Content-Type: application/json" \  -d '{    "asset_url": "https://example.com/reference.png",    "asset_name": "Front view",    "asset_type": "Image",    "library_type": "aigc_avatar",    "group_id": "group-20260720123456-vrt01"  }'

{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view",  "asset_type": "Image",  "status": "PROCESSING",  "ready": false,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}