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

تحديث أصل مادي (Material Asset)

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

PUT
/v1/videos/assets/{assetId}

قم بتحديث asset_name أو metadata؛ أرسل واحداً منهما على الأقل. لا يمكن تغيير رابط المصدر (source URL) أو نوع الأصل (asset type)؛ قم بإنشاء أصل جديد عند تغيير ملف المصدر.

يمكن فقط تحديث الأصل الذي تكون حالته ACTIVE: الأصل الذي تكون حالته PROCESSING سيعيد رمز الخطأ 409 مع seedance_material_preparing، والأصل الذي تكون حالته FAILED سيعيد رمز الخطأ 422.

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

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

curl https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr \
  -X PUT \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_name":"Front view approved","metadata":{"approved_by":"creative-team"},"project_name":"default"}'

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

{
  "id": "asset-20260720123456-qn7wr",
  "object": "seedance.material_asset",
  "project_name": "default",
  "group_id": "group-20260720123456-vrt01",
  "library_type": "aigc_avatar",
  "asset_name": "Front view approved",
  "asset_type": "Image",
  "status": "ACTIVE",
  "ready": true,
  "error_message": null,
  "metadata": {"approved_by": "creative-team"},
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X PUT "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr" \  -H "Content-Type: application/json" \  -d '{    "asset_name": "Front view approved",    "metadata": {      "approved_by": "creative-team"    }  }'
{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view approved",  "asset_type": "Image",  "status": "ACTIVE",  "ready": true,  "error_message": null,  "metadata": {    "approved_by": "creative-team"  },  "created_at": 1782998400000}

التفويض

bearerAuth

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

assetId*string

معرف أصل مادة TokenLab.

جسم الطلب

application/json

تحديث asset_name أو البيانات الوصفية. لا يمكن تغيير رابط المصدر ونوع الأصل؛ قم بإنشاء أصل جديد بدلاً من ذلك.

الخصائص1 <= properties

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json