الفيديو والمواد
الحصول على أصل مادي (Get Material Asset)
استرجاع أصل مادي واحد من Seedance بواسطة معرف أصل TokenLab المادي.
استرجع أصلاً مادياً واحداً وافحص حالة معالجته: 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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معاملات الاستعلام
نطاق المشروع لمورد المادة.
1 <= length <= 128"default"الاستجابة
application/json
application/json
application/json
application/json
application/json