الانتقال إلى المحتوى الرئيسي
ينشئ Seedance 2.0 الفيديو من أصول مرجعية موثوقة — وجه، أو زي، أو منتج، أو صوت. وللحفاظ على اتساق التوليد وامتثاله، تعيش هذه المراجع في مكتبة أصول خاصة يثق بها النموذج وقت الاستدلال. تُتيح OrcaRouter هذه المكتبة عبر /v1/asset. تشرح هذه الصفحة كيف تعمل المكتبة وما المطلوب. للاطلاع على نقاط النهاية الدقيقة والمعاملات وحدة تجربة فورية، راجع API Reference → Seedance Assets.

​
كيف تُبنى المكتبة

  • مجموعة الأصول (Asset Group) — حاوية. في المجموعة البشرية الحقيقية تقابل مجموعة واحدة شخصًا حقيقيًا واحدًا؛ أما في المجموعة الافتراضية فهي تجميع منطقي (مثل شخصية واحدة).
  • الأصل (Asset) — ملف واحد (صورة أو فيديو أو صوت) داخل مجموعة. لا يمكن الإشارة في توليد الفيديو إلا إلى الأصول التي تبلغ الحالة Active.
تُشير إلى أصل جاهز في طلب فيديو بالصيغة asset://<asset_id>.

​
نوعان من المجموعات

عمليات الرفع والإدارة متطابقة في النوعين؛ ولا يختلفان إلا في كيفية إنشاء المجموعة.
الافتراضية (AIGC)البشرية الحقيقية (LivenessFace)
تُستخدم لـالشخصيات الخيالية / الذكاء الاصطناعي، والدعائم، والمشاهدصورة شخص حقيقي
تُنشأ عبراستدعاء إنشاء مباشرتحقق وجه لمرة واحدة يقوم به ذلك الشخص
السببلا توجد هوية لحمايتهاحقوق الصورة الشخصية — تُلتقط الموافقة عند المصدر
كلتا المكتبتين تتطلبان Advanced Creation Rights؛ وحصة السعة مشتركة بينهما. المكتبة البشرية الحقيقية متاحة للحسابات المدعوّة.

​
متطلبات ملفات الأصول

تُقدَّم الأصول كـ عنوان URL قابل للوصول العام (دون رفع ملفات، ودون base64). القيود:
النوعالصيغالقيود
صورةjpeg، png، webp، bmp، tiff، gif، heic/heifنسبة العرض إلى الارتفاع (W/H) 0.4–2.5 · 300–6000 px لكل جانب · < 30 MB
فيديوmp4، mov480p/720p/1080p · 2–15 ثانية · النسبة 0.4–2.5 · 300–6000 px · إجمالي البكسلات 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
صوتwav، mp32–15 ثانية · ≤ 15 MB
محتوى الصورة الشخصية، أفضل الممارسات (لاتساق الوجه):
  • مرجع بالجسم كامل: لقطة عمودية أمامية للجسم بالكامل للشخص.
  • لقطة قريبة للوجه: عمودية، بتعبير محايد، مؤطَّرة فوق الكتفين، مع امتلاء الوجه لنحو ثلثي الإطار.
رفع عدة مراجع جيدة للشخص نفسه في مجموعة واحدة يحسّن مدى وفاء الفيديو المولَّد في إعادة إنتاج وجهه وملابسه.

​
دورة حياة الأصل (الرفع غير متزامن)

يعيد رفع الأصل فورًا قيمة asset_id؛ ثم تُعالَج الملف مسبقًا في الخلفية. استعلم عن الأصل حتى تستقر حالته Status:
  • Processing — لا يزال قيد المعالجة المسبقة؛ واصل الاستعلام.
  • Active — جاهز؛ استخدمه في توليد الفيديو.
  • Failed — رفضته المعالجة المسبقة؛ افحص Error (مثل الصيغة/الحجم، أو حظر من مراجعة المحتوى، أو — للمجموعات البشرية الحقيقية — FaceMismatch).
لا يُضمن اتفاق مستوى الخدمة (SLA) لزمن الرفع؛ أصول الفيديو تستغرق وقتًا أطول من الصور. عنوان URL الموقَّع للتنزيل الذي يُعاد للأصل مؤقت (نحو 12 ساعة).

​
تدفق التحقق البشري الحقيقي

تُنشأ المجموعة البشرية الحقيقية بأن يتحقق الشخص من نفسه مرة واحدة. لا تتعامل خلفيتك مطلقًا مع بيانات وجهه — بل تنسّق التدفق فقط:
1

بدء جلسة

تطلب خلفيتك من OrcaRouter بدء جلسة تحقق. تستردّ رابط H5 (صفحة فحص وجه مستضافة) ومعرّف session_id.
2

يتحقق الشخص

تسلّم رابط H5 للمستخدم النهائي. يفتحه على جهازه الخاص — دون الحاجة إلى تسجيل الدخول إلى OrcaRouter — ويُكمل فحص الوجه. يصرّح مرة واحدة؛ ولاحقًا يمكن إضافة مظاهر جديدة للشخص نفسه إلى المجموعة نفسها دون إعادة التحقق.
3

تُنشأ المجموعة

عند النجاح، تعيد صفحة التحقق توجيه متصفح المستخدم النهائي إلى استدعاء معاودة (callback) من OrcaRouter (يُعالَج تلقائيًا)، وتُسجَّل المجموعة الجديدة لك. إن مرّرت return_url، يعود المستخدم إلى صفحتك.
4

استعلم عن النتيجة

تستعلم خلفيتك عن الجلسة حتى تصبح status بقيمة success (مع group_id الجديد) أو failed. بعد ذلك ترفع الأصول وتولّد الفيديو تمامًا كما في المجموعة الافتراضية.
اتساق الوجه. عند رفع صورة إلى مجموعة بشرية حقيقية، تُقارَن بالمرجع المُتحقَّق منه. يُرفَض أي شخص مختلف (أو وجود عدة وجوه في صورة واحدة) — ويستقر الأصل على Failed / FaceMismatch. يمكن ضبط اسم المجموعة ووصفها بعد الإنشاء عبر عملية تحديث المجموعة.

​
الحصة (Quota)

لحسابك حد أقصى لعدد الأصول (افتراضيًا 100، عبر كل المجموعات). تُرفَض عمليات الرفع التي تتجاوز الحد بالرمز 403.

​
الإشارة إلى أصل في توليد الفيديو

بمجرد أن يصبح الأصل Active، أَشِر إليه بالصيغة asset://<asset_id> ضمن metadata.content[] في طلب فيديو Seedance، وأَشِر إليه في المُحفِّز (prompt) بـ النوع + الموضع ([Image 1]، [Video 1]، [Audio 1]) — لا بمعرّف الأصل الخام مطلقًا: 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
التالي

  • API Reference → Seedance Assets — كل نقطة نهاية، والمعاملات الكاملة، وساحة تفاعلية (هنا تعيش عيّنات الطلب/الاستجابة).
  • فيديو Seedance — نقطة نهاية توليد الفيديو التي تستهلك هذه الأصول.