الفيديو والمواد
إنشاء أصل مادي (Material Asset)
تحميل أصل مادي من Seedance إلى مجموعة مواد في TokenLab.
قم باستيراد رابط مصدر متاح للجمهور إلى مجموعة مواد Seedance. يقوم TokenLab بتخزين المادة لاستخدامها لاحقاً؛ استخدم id الخاص بالأصل المادي الذي تم إرجاعه لعملية الإنشاء، وليس رابط المصدر.
بالنسبة لـ library_type: "aigc_avatar"، يعتبر group_id اختيارياً؛ وبدونه يستخدم TokenLab أو ينشئ مجموعة الصور الرمزية الافتراضية للمؤسسة. أما بالنسبة لـ library_type: "liveness_face"، فإن group_id مطلوب ويجب أن يكون مجموعة TokenLab التي تم إرجاعها بواسطة الحصول على نتيجة التحقق المرئي. كما أن group_id مطلوب أيضاً عندما لا يكون project_name هو default. يجب أن تنتمي المجموعة إلى نفس project_name و library_type، وإلا سيعيد الطلب 400.
| النوع | المدخلات المدعومة |
|---|---|
| صورة | jpeg, jpg, png, webp, bmp, tiff, gif, heic, heif؛ ≤30 ميجابايت؛ العرض والارتفاع [300, 6000] بكسل؛ نسبة العرض إلى الارتفاع [0.4, 2.5]. |
| فيديو | mp4, mov؛ ≤200 ميجابايت. |
| صوت | aac, wav, mp3؛ ≤15 ميجابايت. |
يتحقق TokenLab من رابط المصدر، ونوع الوسائط، وحجم الملف، وأبعاد الصورة (عندما تكون قابلة للقراءة) قبل قبول الطلب. المصدر الذي يفشل في هذه الفحوصات يعيد 400 مع رمز seedance_material_source_*، على سبيل المثال seedance_material_source_invalid (أبعاد الصورة أو نسبة العرض إلى الارتفاع خارج النطاق)، أو seedance_material_source_type_mismatch، أو seedance_material_source_too_large، أو seedance_material_source_url_unreachable. يتم تقييم متطلبات الوسائط والوجه الأخرى أثناء المعالجة، لذا فإن القبول لا يعني أن الأصل جاهز: انتظر حتى تصبح الحالة ACTIVE وافحص error_message في حال فشل المعالجة.
الطلب الناجح يعيد 201 مع status: "PROCESSING". قم باستطلاع الحصول على أصل مادي (Material Asset) حتى تصبح status هي ACTIVE. بالنسبة لمجموعات الأشخاص الحقيقيين، ترتبط المجموعة الواحدة بشخص واحد تم التحقق منه؛ قد تفشل عمليات التحميل التي تحتوي على وجوه متعددة أو وجه لا يطابق الشخص الذي تم التحقق منه.
يقوم project_name بتحديد نطاق الموارد داخل مؤسستك ويكون افتراضياً default. استخدم نفس القيمة الحساسة لحالة الأحرف للمجموعات والأصول ذات الصلة. أرسلها في نص JSON لطلبات POST/PUT وفي سلسلة الاستعلام (query string) لطلبات GET/DELETE.
مثال على الطلب
curl https://api.tokenlab.sh/v1/videos/assets \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","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",
"asset_type": "Image",
"status": "PROCESSING",
"ready": false,
"error_message": null,
"metadata": null,
"created_at": 1782998400000,
"updated_at": 1782998400000
}curl -X POST "https://example.com/v1/videos/assets" \ -H "Content-Type: application/json" \ -d '{ "asset_url": "https://example.com/reference.png", "asset_name": "Front view", "asset_type": "Image", "library_type": "aigc_avatar", "group_id": "group-20260720123456-vrt01" }'{ "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": "PROCESSING", "ready": false, "error_message": null, "metadata": null, "created_at": 1782998400000}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
جسم الطلب
application/json
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json