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

الحصول على أصل مادي (Get Material Asset)

استرجاع أصل مادي واحد من Seedance بواسطة معرف أصل TokenLab المادي.

GET
/v1/videos/assets/{assetId}

استرجع أصلاً مادياً واحداً وافحص حالة معالجته: PROCESSING أو ACTIVE أو FAILED أو DELETED. لا يمكن استخدام الأصل في إنشاء الفيديو إلا عندما تكون قيمة ready هي true وتكون status هي ACTIVE. عند فشل المعالجة، توضح error_message السبب.

إذا أرجع إنشاء الفيديو رسالة Seedance material asset not found or not accessible، فتحقق من أنك قمت بتمرير id الخاص بهذا الأصل المادي، وليس group_id الخاص بالمادة.

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

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

curl "https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

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

{
  "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": "ACTIVE",
  "ready": true,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"
{  "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": "ACTIVE",  "ready": true,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

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

assetId*string

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

project_name?string

نطاق المشروع لمورد المادة.

الطول1 <= length <= 128
الافتراضي"default"

الاستجابة

application/json

application/json

application/json

application/json

application/json