Seedance 2.5 Flash API
المرجع الكامل لواجهة API الخاصة بنماذج Seedance 2.5 Flash لتوليد الفيديو من ByteDance.
إصدارات النموذج
تدعم واجهة API ثلاثة إصدارات من النموذج:
مقارنة سريعة
نسب العرض إلى الارتفاع المدعومة
يدعم نموذجا التوليد من نص والتوليد من مراجع النسب التالية:
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
لا يدعم نموذج التوليد من صورة المعامل aspect_ratio.
خيارات الدقة
Seedance 2.5 Flash Text to Video
نقطة النهاية
POST /api/v1/video/task
معاملات الطلب
المعاملات المطلوبة
المعاملات الاختيارية
مثال على الطلب
javascript
Seedance 2.5 Flash Image to Video
معاملات الطلب
المعاملات المطلوبة
المعاملات الاختيارية
لا تُدرج
aspect_ratioفي طلبات التوليد من صورة، فهذا النموذج لا يدعم هذا المعامل.
مثال على الطلب
javascript
Seedance 2.5 Flash Reference to Video
معاملات الطلب
المعاملات المطلوبة
الوسائط المرجعية
جميع الوسائط المرجعية اختيارية. يمكن إرسال صور فقط أو فيديو فقط أو صوت فقط، كما يمكن إرسال طلب من دون وسائط مرجعية. يُنصح باستخدام نموذج التوليد من نص عند عدم استخدام مراجع.
العناصر النائبة للإشارة @ (AT)
تربط ميزة الإشارة @ (AT) الوسائط المرجعية بالوصف النصي من خلال عناصر نائبة مرقّمة بصيغة <<<...>>>. يبدأ الترقيم من 1 لكل نوع من الوسائط على حدة ويتبع ترتيب عناصر المصفوفة المقابلة:
مثلًا، إذا كانت الصورة الأولى مرجعًا للشخصية والثانية مرجعًا للمشهد، فاستخدم <<<image_1>>> للشخصية و<<<image_2>>> للمشهد في prompt. يجب أن يشير كل عنصر نائب إلى عنصر موجود في المصفوفة المقابلة.
المعاملات الاختيارية
مثال على الطلب
javascript
مثال على طلب توليد فيديو من مراجع باستخدام الإشارة @ (AT)
javascript
حدود الوسائط
تنطبق هذه الحدود على صور الإطارين الأول والأخير وعلى الوسائط المرجعية للنماذج الواردة في هذه الصفحة.
تخضع المقاطع الصوتية المرجعية ومقاطع الفيديو المرجعية لحدّين منفصلين، بحيث لا يتجاوز مجموع المدد لكل نوع 30 ثانية. وتُحسب الأعداد بصورة مستقلة أيضًا: حتى 10 صور و5 مقاطع فيديو و5 مقاطع صوتية.
تتطلب جميع النماذج تحديد resolution وduration، ولا توجد لهما قيم افتراضية. يستخدم نموذجا التوليد من نص والتوليد من مراجع النسبة 16:9 عند إغفال aspect_ratio. القيمة الافتراضية لخيار الصوت هي true، ويمكن ضبطه على false لتوليد فيديو صامت.
تنسيق الاستجابة
الاستجابة الأولية
تُرجع جميع النماذج task_id للاستعلام الدوري عن الحالة:
json
استجابة الاستعلام الدوري
أرسل طلب GET /api/v1/video/{taskId} دوريًا للتحقق من الحالة:
json
قيم الحالة
submitted: قُبلت المهمة وهي بانتظار المعالجةprocessing: جارٍ توليد الفيديوsucceed: اكتمل توليد الفيديوfailed: تعذّر توليد الفيديو
مدة المعالجة
تختلف مدة المعالجة باختلاف مدة الفيديو ودقته وحالة قائمة الانتظار الحالية.
استعلم عن الحالة كل 5 إلى 10 ثوانٍ.
أفضل الممارسات
- المعاملات المطلوبة: أرسل دائمًا
promptوresolutionوduration. المعاملaspect_ratioاختياري عند التوليد من نص أو من مراجع، وقيمته الافتراضية16:9 - نسبة الأبعاد عند التوليد من صورة: لا ترسل
aspect_ratioفي طلبات التوليد من صورة - مقاطع الفيديو المرجعية: مقاطع الفيديو اختيارية. التزم بالحدود الموضّحة لمدة كل مقطع وللمدة الإجمالية للمقاطع
- الصور المرجعية: الصور اختيارية بصرف النظر عن استخدام الفيديو والصوت. أرسل حتى 10 عناوين URL لصور مدعومة
- المقاطع الصوتية المرجعية: يجب أن تتراوح مدة كل مقطع بين ثانيتين و30 ثانية وألا يتجاوز حجمه 15 ميغابايت، على ألا تتجاوز المدة الإجمالية 30 ثانية
- ترتيب المراجع: رتّب عناصر
imagesوvideosوaudiosبالترتيب المقصود، والتزم بهذا الترتيب عند الإشارة إليها في الوصف النصي - الصوت: أغفل
soundلاستخدام القيمة الافتراضيةtrueأو اضبطه علىfalseلتعطيل توليد الصوت