Skip to main content
POST
قم باستيراد رابط مصدر متاح للجمهور إلى مجموعة مواد Seedance. يقوم TokenLab بتخزين المادة لاستخدامها لاحقاً؛ استخدم id الخاص بالأصل المادي الذي تم إرجاعه لعملية الإنشاء، وليس رابط المصدر. بالنسبة لـ library_type: "aigc_avatar"، فإن group_id اختياري؛ حيث يستخدم TokenLab أو ينشئ مجموعة الصور الرمزية الافتراضية للمؤسسة. بالنسبة لـ library_type: "liveness_face"، فإن group_id مطلوب ويجب أن يكون مجموعة TokenLab التي تم إرجاعها بواسطة الحصول على نتيجة التحقق المرئي. يتحقق TokenLab من رابط المصدر ونوع الوسائط وحجم الملف وأبعاد الصور القابلة للقراءة. قبول الاستيراد لا يعني أن الأصل جاهز: انتظر ACTIVE وافحص error_message عند فشل المعالجة. تُفحص شروط الوسائط والوجوه الأخرى أثناء المعالجة. عملية الإنشاء غير متزامنة. قم بإجراء استعلام (Poll) لـ الحصول على أصل مادي (Material Asset) حتى تصبح status هي ACTIVE. بالنسبة لمجموعات الأشخاص الحقيقيين، ترتبط كل مجموعة بشخص واحد تم التحقق منه؛ قد تفشل عمليات التحميل التي تحتوي على وجوه متعددة أو وجه لا يطابق الشخص الذي تم التحقق منه. يعزل project_name الموارد داخل المؤسسة المصادق عليها. قيمته الافتراضية default؛ استخدم القيمة نفسها مع مراعاة حالة الأحرف للمجموعات والأصول المرتبطة. أرسله في جسم JSON مع POST/PUT وفي معاملات الاستعلام مع GET/DELETE.

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

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

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json
asset_url
string<uri>
مطلوب

رابط مصدر يمكن الوصول إليه عاماً للاستيراد. يقوم TokenLab بتخزين المادة لاستخدامها لاحقاً؛ لا تعتمد على هذا الرابط كعنوان دائم للمادة.

asset_name
string

اسم عرض اختياري مخزن مع أصل المادة.

Required string length: 1 - 128
asset_type
enum<string>
افتراضي:Image
الخيارات المتاحة:
Image,
Video,
Audio
library_type
enum<string>
افتراضي:aigc_avatar

فئة مكتبة المواد. aigc_avatar مخصص لمواد الصور الرمزية الافتراضية. liveness_face مخصص لمواد التحقق من الأشخاص الحقيقيين.

الخيارات المتاحة:
aigc_avatar,
liveness_face
group_id
string

معرف مجموعة مواد TokenLab. مطلوب لمواد liveness_face؛ اختياري لـ aigc_avatar.

project_name
string
افتراضي:default

نطاق المشروع لأصل المادة. يتم عزل الأصول والمجموعات حسب المشروع داخل المؤسسة الموثقة.

Required string length: 1 - 128
metadata
object | null

بيانات وصفية اختيارية للعميل مخزنة مع أصل المادة.

الاستجابة

تم إنشاء أصل المادة

id
string
مطلوب

معرف أصل مادة TokenLab. استخدم هذا كـ material_asset_id بعد أن يصبح الأصل ACTIVE.

object
enum<string>
مطلوب
الخيارات المتاحة:
seedance.material_asset
library_type
enum<string>
مطلوب
الخيارات المتاحة:
aigc_avatar,
liveness_face
asset_type
enum<string>
مطلوب
الخيارات المتاحة:
Image,
Video,
Audio
status
enum<string>
مطلوب
الخيارات المتاحة:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
مطلوب

تكون true عندما يكون الأصل نشطاً وغير محذوف.

group_id
string | null

معرف مجموعة مواد TokenLab التي تمتلك أصل المادة هذا.

project_name
string

نطاق المشروع لأصل المادة هذا.

asset_name
string | null
error_message
string | null

خطأ معالجة نهائي آمن للنشر. تشمل إخفاقات التحقق من المصدر الدائمة قيود الأبعاد المرفوضة.

metadata
object | null
created_at
integer

طابع زمني بنظام Unix يوضح وقت إنشاء سجل أصل المادة.

updated_at
integer

طابع زمني بنظام Unix يوضح وقت آخر تحديث لسجل أصل المادة.