الفيديو والمواد

إنشاء مجموعة أصول المواد

إنشاء مجموعة مواد للصور الرمزية الافتراضية (virtual-avatar) في Seedance.

POST
/v1/videos/assets/groups

قم بإنشاء مجموعة مواد من النوع library_type: "aigc_avatar" للصور الرمزية الافتراضية، والمنتجات، والأنماط، والمراجع الأخرى القابلة لإعادة الاستخدام التي لا تتطلب التحقق من هوية الشخص الحقيقي. حقل group_name اختياري (من 1 إلى 128 حرفاً) وحقل description اختياري (حتى 500 حرف). يُرجع الطلب الناجح رمز الحالة 201.

لا يمكن إنشاء مجموعات للأشخاص الحقيقيين باستخدام نقطة النهاية هذه؛ حيث يُرجع النوع library_type: "liveness_face" رمز الخطأ 400. قم بإنشائها من خلال التحقق المرئي.

يقوم project_name بتحديد نطاق الموارد داخل مؤسستك، والقيمة الافتراضية له هي default. استخدم نفس القيمة (مع مراعاة حالة الأحرف) للمجموعات والأصول ذات الصلة. أرسل القيمة في نص JSON لطلبات POST/PUT وفي سلسلة الاستعلام (query string) لطلبات GET/DELETE.

مثال على الطلب

curl https://api.tokenlab.sh/v1/videos/assets/groups \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_name":"Product references","description":"Reusable product shots","project_name":"default"}'

مثال على الاستجابة

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Product references",
  "description": "Reusable product shots",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets/groups" \  -H "Content-Type: application/json" \  -d '{    "library_type": "aigc_avatar",    "group_name": "Product references",    "description": "لقطات منتجات قابلة لإعادة الاستخدام"  }'
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Product references",  "description": "لقطات منتجات قابلة لإعادة الاستخدام",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json