Seedance 2.0 API
مرجع API الكامل لنماذج إنشاء الفيديو Seedance 2.0 من ByteDance.
إصدارات النماذج
تدعم هذه الواجهة ستة إصدارات:
مقارنة سريعة
نسب الأبعاد المدعومة
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
خيارات الدقة
Seedance 2.0 من النص إلى الفيديو
نقطة النهاية
POST /api/v1/video/task
معلمات الطلب
إلزامية
اختيارية
مثال على الطلب
javascript
Seedance 2.0 من الصورة إلى الفيديو
معلمات الطلب
إلزامية
اختيارية
مثال على الطلب
javascript
Seedance 2.0 من المراجع إلى الفيديو
معلمات الطلب
إلزامية
الوسائط المرجعية
أرسل 1-9 صور. يمكن إغفال الصور فقط عند توفير فيديو مرجعي واحد على الأقل.
العناصر النائبة للإشارة @ (AT)
تربط ميزة @ (AT) الوسائط المرجعية بالوصف عبر عناصر نائبة مرقمة <<<...>>>. يبدأ الترقيم من 1 بصورة مستقلة لكل نوع من الوسائط، ويتبع ترتيب المصفوفة المقابلة:
على سبيل المثال، إذا كانت الصورة الأولى مرجعًا للشخصية والثانية مرجعًا للمشهد، فاستخدم <<<image_1>>> للشخصية و<<<image_2>>> للمشهد في prompt. يجب أن يشير كل عنصر نائب إلى عنصر موجود في مصفوفتِه المقابلة.
اختيارية
مثال على الطلب
javascript
مثال طلب من المراجع إلى الفيديو باستخدام @ (AT)
javascript
إصدارات Fast
تعطي إصدارات Fast الأولوية لسرعة المعالجة. تدعم جميع نماذج Fast الإخراج بدقتي "480p" و"720p" فقط. وفيما عدا ذلك، تتبع نماذج Fast من النص إلى الفيديو ومن الصورة إلى الفيديو بنية الطلبات القياسية المقابلة، بينما يستخدم Fast من المراجع إلى الفيديو حدود الوسائط المرجعية نفسها الخاصة بالنموذج القياسي.
مثال طلب Fast
javascript
مثال طلب Fast من المراجع إلى الفيديو باستخدام @ (AT)
javascript
معلمات Seedance 2.0 Fast من المراجع إلى الفيديو
إلزامية
الوسائط المرجعية
تنطبق قاعدة ترقيم العناصر النائبة من 1 الموضحة أعلاه أيضًا على نموذج Fast من المراجع إلى الفيديو.
اختيارية
حدود الوسائط
تنطبق هذه الحدود على صور الإطار الأول والأخير والوسائط المرجعية للنماذج الواردة في هذه الصفحة.
للصوت المرجعي والفيديو المرجعي حد إجمالي مستقل للمدة قدره 15 ثانية لكل نوع. الأعداد مستقلة: حتى 9 صور و3 فيديوهات و3 مقاطع صوتية. لا تؤدي إضافة الفيديوهات إلى تقليل عدد الصور المسموح به.
تستخدم جميع النماذج 720p افتراضيًا، لكن يجب تقديم resolution مع ذلك. القيمة الافتراضية لمفتاح الصوت هي true؛ ولا يغيّر هذا المفتاح ولا الصوت المرجعي السعر. يتطلب نموذج من المراجع إلى الفيديو صورة أو فيديو واحدًا على الأقل؛ ولا يدعم الطلبات التي تحتوي على الصوت فقط. تؤدي إضافة فيديوهات مرجعية إلى مضاعفة تكلفة الإنشاء بغض النظر عن عددها أو مدتها.
تنسيق الاستجابة
الاستجابة الأولية
تعيد جميع النماذج task_id للاستعلام الدوري:
json
استجابة الاستعلام الدوري
استعلم دوريًا عن GET /api/v1/video/{taskId} للتحقق من الحالة:
json
قيم الحالة
submitted: تم قبول المهمة وهي تنتظر المعالجةprocessing: جارٍ إنشاء الفيديوsucceed: اكتمل إنشاء الفيديوfailed: فشل إنشاء الفيديو
وقت المعالجة
النماذج القياسية: 3-8 دقائق بحسب المدة والدقة.
نماذج Fast: 1-4 دقائق لمعظم الإعدادات.
تحقق من الحالة كل 5-10 ثوانٍ.
أفضل الممارسات
- اختر الإصدار المناسب: استخدم نماذج Fast للتجارب المتكررة والنماذج القياسية للإخراج النهائي
- صِف الحركة بوضوح: أدرج أوصافًا محددة للحركة في الأوصاف النصية
- اختيار الدقة: تدعم جميع نماذج Seedance 2.0 القياسية
480pو720pو1080pو4k؛ وتدعم جميع نماذج Fast دقتي480pو720pفقط - ترتيب المراجع: رتّب
imagesوvideosوaudiosبشكل مقصود، وأشر إليها باتساق في الوصف - طلبات الفيديو فقط: استخدم مصفوفة
imagesفارغة فقط عند توفير فيديو مرجعي واحد على الأقل - مدة الوسائط: اجعل مدة كل مقطع صوتي وفيديو مرجعي بين 2 و15 ثانية
- استخدام الصوت: أغفل
soundلاستخدام قيمته الافتراضيةtrue، أو اضبطه علىfalseلتعطيل الصوت المُنشأ