هل يمكنني رفع صورة وجه وإعادة استخدامها في Seedance؟

نعم. يمكنك رفع صورة وجه أو شخص كـ private asset واستخدامها في إنشاء فيديو Seedance. هذا مفيد لسير عمل الشخصيات المتكررة، لكنه إنشاء موجه بالمرجع وليس face swap مضمونًا.

هل Seedance Private Asset Library هي نفسها face swap؟

لا. إنها تسمح لـ Seedance باستخدام assets المرفوعة كمراجع إنشاء قابلة لإعادة الاستخدام. الهدف هو اتساق الشخصية أو الموضوع في الفيديو المولد.

هل يمكنني الجمع بين asset لشخص وصورة مشهد؟

نعم. النمط الشائع هو وضع asset الشخص أولًا في image_urls ورابط صورة المشهد ثانيًا، ثم استخدام تسميات مثل Image 1 و Image 2 في prompt.

ما task types في Seedance API التي تدعم private assets؟

تعمل private assets مع seedance-2-less-restriction و seedance-2-fast-less-restriction. الأنواع الصارمة مثل seedance-2 و seedance-2-fast لا تدعم asset://.

ما الفرق بين private assets و auto-upload mode؟

private assets مراجع مُدارة ترفعها مرة واحدة وتعيد استخدامها. أما auto-upload فيُدخل الروابط الخام مؤقتًا لمهام لمرة واحدة عند تفعيل auto_upload_assets: true.

هل يمكنني اختبار private assets في Playground؟

private assets هي أساسًا سير عمل API و backend. إذا لم يعرض Playground رفع asset والحالة ومراجع asset:// واختيار task type less-restriction، فغالبًا يتم الاختبار باستخدام cURL أو Postman أو backend code.

كيفية استخدام Seedance Private Assets مع Seedance API

Q: ما هو Seedance private asset؟

Seedance private asset هو مرجع قابل لإعادة الاستخدام يتم رفعه إلى PiAPI لإنشاء فيديو باستخدام Seedance. عندما يصبح Active، يمكنك استخدامه في المهام اللاحقة بصيغة asset:// بدل تمرير رابط الملف الخام نفسه كل مرة.

يدعم PiAPI الآن Seedance Private Asset Library، وهو سير عمل في Seedance API لرفع المراجع القابلة لإعادة الاستخدام ثم استدعائها لاحقًا بصيغة asset://<asset_id>.

تتيح لك Seedance Private Asset Library رفع مراجع مثل الوجه أو الشخصية أو المنتج أو المشهد أو الفيديو أو الصوت، ثم استخدامها لاحقًا في مهام Seedance API. هذه الميزة مناسبة لسير العمل الذي يحتاج إلى مراجع متكررة واتساق في الشخصية، وليست أداة face swap تقليدية أو inpainting أو تحرير صور بدقة البكسل.

أهم النقاط

استخدم private assets عندما يحتاج وجه أو شخصية أو منتج أو موضوع إلى الظهور في عدة عمليات إنشاء فيديو لاحقة.
استخدم الروابط الخام للخلفيات أو المشاهد أو العناصر التي تُستخدم مرة واحدة فقط.
استخدم auto_upload_assets: true عندما يحتاج مرجع من المستخدم إلى إدخال مؤقت لمهمة واحدة.
يجب أن يصل private asset إلى حالة Active قبل استخدامه في مهمة Seedance.
مراجع asset:// تعمل مع seedance-2-less-restriction و seedance-2-fast-less-restriction، وليس مع task types الصارمة.

إجابة سريعة

Seedance private assets هي أفضل خيار للمراجع القابلة لإعادة الاستخدام في Seedance API. ارفع المرجع مرة واحدة، انتظر حتى يصبح Active، ثم استخدمه في مهام الفيديو اللاحقة باستخدام asset://<asset_id>.

ما هي Seedance Private Assets؟

Seedance private assets هي ملفات قابلة لإعادة الاستخدام ترفعها تطبيقاتك إلى PiAPI قبل إنشاء الفيديو. بعد الرفع، يعيد PiAPI قيمة asset_id. عندما يصبح asset في حالة Active، يمكن لطلبات Seedance API استخدامه بهذه الصيغة. تفاصيل endpoints والحصص ودورة الحياة موجودة في وثائق Private Asset Library.

asset://<asset_id>

بدل إرسال صورة الوجه نفسها أو صورة الشخصية أو لقطة المنتج أو مقطع الفيديو أو مرجع الصوت مرارًا، ترفعها مرة واحدة وتعيد استخدام asset ID في عدة مهام.

private asset هو مرجع قابل لإعادة الاستخدام لإنشاء فيديو باستخدام Seedance.

ما المشكلة التي تحلها؟

تواجه نماذج إنشاء الفيديو بالذكاء الاصطناعي صعوبة عندما يريد المستخدم ظهور الموضوع نفسه عبر عدة prompts أو مشاهد أو نسخ إبداعية. قد يساعد الرابط الخام في مهمة واحدة، لكنه ليس مثاليًا عندما يجب إعادة استخدام المرجع مرات كثيرة.

تشمل حالات الاستخدام الشائعة الحفاظ على الشخص أو الشخصية نفسها عبر عدة فيديوهات، بناء منتجات avatar أو influencer، إعادة استخدام مرجع منتج في عدة إعلانات، الحفاظ على طاقم ثابت في القصص القصيرة، الجمع بين شخص ثابت وخلفيات متغيرة، وتقليل الرفع المتكرر في أنظمة backend.

للحصول على نظرة عامة على النموذج، ابدأ من دليل Seedance 2.0 API.

ما الذي لا تمثله Private Assets؟

لا ينبغي وصف Seedance Private Asset Library كأداة face swap أو inpainting أو تركيب صور دقيق. إذا رفعت صورة شخص وصورة مشهد، يستخدم Seedance هذه المدخلات كمراجع إنشاء. الناتج فيديو مولد بإرشاد المرجع، وليس إدخالًا دقيقًا للشخص في الصورة على مستوى البكسل.

Private Assets مقابل الروابط الخام و Auto-Upload

النمط	الأفضل لـ	مثال الإدخال	متى تستخدمه
Managed private asset	أشخاص أو شخصيات أو منتجات أو مواضيع متكررة	`asset://asset-123`	عندما سيظهر المرجع نفسه في عدة مهام مستقبلية.
Raw URL	مشهد أو خلفية أو عنصر يستخدم مرة واحدة	`https://your-cdn.com/scene.jpg`	عندما يكون المرجع مهمًا للمهمة الحالية فقط.
Auto-uploaded ephemeral asset	مراجع مؤقتة من المستخدم	URL + `auto_upload_assets: true`	عندما تريد من PiAPI إدخال المرجع مؤقتًا.
Managed cast + raw scenery	موضوع ثابت مع خلفيات متغيرة	`asset://person`, `https://.../scene.jpg`	عندما يتكرر الموضوع ولا تتكرر الخلفية.

القاعدة البسيطة: إذا كان المرجع سيُستخدم لاحقًا، اجعله private asset. إذا كان مطلوبًا مرة واحدة فقط، استخدم رابطًا خامًا أو auto-upload.

كيف يعمل سير العمل

ارفع المرجع القابل لإعادة الاستخدام.
انتظر حتى تصبح الحالة Active.
أرسل مهمة Seedance تحتوي على asset://<asset_id> في image_urls أو video_urls أو audio_urls.
أشر إلى المدخلات في prompt بصيغ مثل Image 1 و Image 2 و Video 1 و Audio 1.
تابع مهمة Seedance حتى يكتمل الفيديو.

ترتيب المراجع مهم. إذا كان private asset أول عنصر في image_urls وكانت صورة المشهد ثاني عنصر، فإن Image 1 هو private asset و Image 2 هي الخلفية.

{
  "image_urls": [
    "asset://asset-20260607154123-aaaa1",
    "https://your-cdn.com/scenic-background.jpg"
  ]
}

في prompt يمكنك كتابة:

Image 1 is the person reference. Image 2 is the scenic background.

مثال: استخدام asset لشخص مع صورة مشهد

يمكنك رفع صورة شخص كـ private asset، وتمرير صورة المشهد كرابط خام، ثم طلب إنشاء فيديو من Seedance باستخدام المرجعين معًا. النتيجة فيديو مولد بإرشاد المرجع، وليست تركيبًا دقيقًا للصورة.

{
  "image_urls": ["asset://asset-person-reference", "https://your-cdn.com/scenic-background.jpg"],
  "prompt": "Image 1 is the person reference. Image 2 is the scenic background. Generate a cinematic 5-second video of the person from Image 1 standing naturally in the location from Image 2."
}

مثال API

الخطوة 1: رفع private asset

يجب أن يكون رابط المصدر قابلًا للوصول العام أثناء قيام PiAPI بجلب الملف وإدخاله. إبقاؤه متاحًا لمدة 24 ساعة على الأقل هو الخيار الأكثر أمانًا.

curl --request POST "https://api.piapi.ai/api/v1/asset/upload"
  --header "X-API-Key: $PIAPI_API_KEY"
  --header "Content-Type: application/json"
  --data '{"url":"https://your-cdn.com/person-reference.jpg","asset_type":"Image","name":"main-character"}'

الخطوة 2: التحقق من حالة asset

curl --request GET "https://api.piapi.ai/api/v1/asset/list?status=active,processing,failed"
  --header "X-API-Key: $PIAPI_API_KEY"

إذا بقي asset في حالة Processing، انتظر ثم تحقق مرة أخرى. إذا كانت الحالة Failed، راجع رسالة الخطأ وارفع ملفًا مصححًا.

الخطوة 3: إرسال Seedance task مع `asset://`

استخدم seedance-2-less-restriction أو seedance-2-fast-less-restriction. الأنواع الصارمة مثل seedance-2 و seedance-2-fast لا تدعم مراجع asset://.

Auto-Upload للمراجع لمرة واحدة

إذا كان المرجع مطلوبًا لمهمة واحدة فقط، استخدم auto_upload_assets: true. يستطيع PiAPI إدخال روابط ليست asset:// مؤقتًا، استخدامها للمهمة، ثم تنظيفها بعد فترة الاحتفاظ.

أفضل الممارسات

استخدم private assets للوجوه أو الشخصيات أو المنتجات أو مواضيع العلامة التجارية المتكررة.
اترك الخلفيات التي تُستخدم مرة واحدة كرابط خام.
استخدم تسميات واضحة في prompt مثل Image 1 و Image 2 و Video 1 و Audio 1.
انتظر حالة Active قبل إنشاء الفيديو.
خطط للحصص و TTL وحقوق استخدام مراجع المستخدم.

أخطاء شائعة

استخدام task type صارم

seedance-2 لا يعمل مع asset://. استخدم إحدى نسخ less-restriction.

استخدام asset قبل أن يصبح جاهزًا

التدفق الصحيح: رفع asset -> متابعة الحالة -> انتظار Active -> إرسال مهمة Seedance.

تحويل كل خلفية إلى managed asset

احتفظ بمساحات private asset للمراجع التي تحتاج إلى اتساق عبر عدة مهام.

FAQ

ما هو Seedance private asset؟

هو مرجع قابل لإعادة الاستخدام يتم رفعه إلى PiAPI لإنشاء فيديو باستخدام Seedance. عندما يصبح Active، يمكن استخدامه بصيغة asset://<asset_id>.

هل يمكنني إعادة استخدام صورة وجه؟

نعم، كإنشاء موجه بالمرجع. لا يعني ذلك face swap دقيقًا ومضمونًا.

هل هو نفس face swap؟

لا. الهدف هو اتساق الشخصية أو الموضوع في الفيديو المولد.

الخلاصة

تمنح Seedance Private Asset Library المطورين طريقة أنظف لبناء سير عمل مراجع قابلة لإعادة الاستخدام مع Seedance API. ارفع مرجعًا، تأكد أنه Active، ثم أرسل مهمة seedance-2-less-restriction تستخدم asset مع prompt وأي روابط خام لمرة واحدة. يمكنك اختبار Seedance من Seedance workspace.

المصادر:

PiAPI Private Asset Library docs: https://piapi.ai/docs/seedance-api/private-asset
Seedance 2.0 arXiv page: https://arxiv.org/abs/2604.14148