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

تحديث مجموعة أصول المواد (Material Asset Group)

تحديث مجموعة مواد Seedance المملوكة للمؤسسة الحالية.

PUT
/v1/videos/assets/groups/{groupId}

قم بتحديث اسم العرض (group_name)، أو description، أو metadata الخاصة بمجموعة مواد. أرسل واحداً منها على الأقل، وإلا سيعيد الطلب رمز الخطأ 400. تحتفظ مجموعة الأشخاص الحقيقيين بتعيين الشخص الموثق الخاص بها. إذا كانت إحدى المواد في المجموعة لا تزال قيد الإعداد، فقد يعيد الطلب رمز الخطأ 409؛ حاول مجدداً بعد فترة قصيرة.

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

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

curl https://api.tokenlab.sh/v1/videos/assets/groups/group-20260720123456-vrt01 \
  -X PUT \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group_name":"Updated references","description":"Images approved for summer videos","project_name":"default"}'

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

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Updated references",
  "description": "Images approved for summer videos",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X PUT "https://example.com/v1/videos/assets/groups/group-20260720123456-vrt01" \  -H "Content-Type: application/json" \  -d '{    "group_name": "Updated references",    "description": "صور معتمدة لفيديوهات الصيف"  }'
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Updated references",  "description": "صور معتمدة لفيديوهات الصيف",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

معاملات المسار

groupId*string

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json