ByteDance: Seedance 2.5
ينشئ Seedance 2.5 الصوت والفيديو معًا لمشاهد أطول ومراجع غنية بالصور والفيديو والصوت وتعديلات محددة. توثّق ByteDance Seed توليدًا حتى 30 ثانية وتوجيهًا برندر طيني وتحكّمًا في الكاميرا واستكمال اللقطات الموجودة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Seedance 2.5 هو نموذج ByteDance Seed للتوليد المشترك للصوت والفيديو. يطوّر Seedance 2.0 بسرد أطول ومراجع متعددة الوسائط أغنى وتحرير أدق. يمكن لمتطلبات نصية تحديد مشهد، بينما تنقل الصور والفيديو والصوت المظهر والحركة واللغة السينمائية والصوت. والنتيجة لقطات سمعية بصرية لمفهوم فيلم أو قصة منتج أو فيديو موسيقي أو تصوّر مسبق أو سرد قصير.
مشهد كامل في عملية توليد واحدة ترفع الجهة المنتجة سقف التوليد في تمريرة واحدة من 15 ثانية سابقًا إلى 30 ثانية. يتيح ذلك مساحة للتمهيد والتطور والخاتمة، مع عدة لقطات مترابطة أو حركة كاميرا متصلة. ويتتبع مثالها للأداء المسرحي مغنيًا من غرفة الملابس عبر ممر إلى المسرح، بدل عرض الوصول وحده. صف تسلسل الأفعال ومسار الكاميرا بترتيبهما المقصود. ولقصة منتج، خطط للكشف والعرض والتكوين الختامي بحيث يضيف كل جزء شيئًا مرئيًا.
استكمال اللقطات الموجودة يستطيع Seedance 2.5 تمديد مقطع إلى الأمام أو الخلف، مستخدمًا الشخصيات والبيئة والحركة واتجاه الكاميرا المستقرة إشارات للاستمرارية. يصف الاستكمال الأمامي ما يحدث بعد اللحظة الأخيرة؛ ويصف الاستكمال الخلفي ما يمهد للبداية. قدّم اللقطات الموجودة واشرح الفعل الجديد أو تغير المكان أو حركة الكاميرا. راجع الوصلة والجزء الجديد، بما يشمل مظهر الموضوع والصوت واتجاه الحركة. يناقش إعلان الشركة المصنّعة تكرار التمديد، بينما تصف صفحة النموذج خطوتين للتمديد؛ وترتبط ميزانية التمديد المتاحة بسير العمل المحدد، لا بوعد عام بفيديو غير محدود.
مراجع الصور والفيديو والصوت ميزانية المراجع المعلنة تصل إلى 50 مادة في عملية توليد واحدة: 30 صورة و10 مقاطع فيديو و10 مقاطع صوت. يمكن للصور تحديد الشخصيات والمنتجات والمواقع والدعائم أو الأسلوب. ويمكن للفيديو نقل الأداء والوتيرة وحركة الكاميرا. ويمكن للصوت تزويد الحوار أو الموسيقى أو الأجواء أو الإيقاع. أسند لكل مادة دورًا واضحًا: مرجع للموضوع، وآخر للبيئة، وفيديو لحركة الكاميرا، ومقطع صوتي للتوقيت. توجه هذه المواد التفسير؛ ولا تضمن إعادة كل تفصيل بدقة.
التوجيه بالرندر الطيني وتخطيط الأداء يمكن لمشهد ثلاثي الأبعاد بلا خامات تحديد التخطيط المكاني والوضعيات ومسارات الحركة وزوايا الكاميرا قبل إخراج المظهر النهائي. تعرض الجهة المنتجة استخدام بنية الرندر الطيني هذه مع صورة منفصلة لتصميم الشخصية والخامات واللون والأجواء. يفيد ذلك رسومًا متحركة أو تصورًا لعملية تجميع يكون فيه تنظيم المشهد أهم من مرجع أسلوبي فضفاض. حدّد المصدر المتحكّم في تخطيط الحركة والمصدر المتحكّم في المظهر. ويستخدم النموذج أيضًا الإشارات المكانية لتوجيه اتجاه الضوء وحرارته اللونية وشدته ومواضع الظلال.
التعديلات الزمنية والتحكّم في الكاميرا يدعم Seedance 2.5 استهداف فترة زمنية أثناء التوليد وتعديل الشخصيات أو الأفعال أو عناصر القصة في مقطع موجود. ويمكن للتحرير القائم على الطوابع الزمنية استهداف الصوت والمحتوى البصري معًا؛ حدّد الفترة والعنصر المطلوب تعديله. تعرض الشركة المصنّعة استبدال خلفية الشاشة الخضراء وتعديلات قائمة على المراجع وتغيير حركة الكاميرا مع الاحتفاظ بفعل المشهد وأسلوبه. ينبغي أن تحدّد متطلبات التحرير المقطع المصدر والفترة والعنصر المطلوب تغييره والاستمرارية المطلوب حفظها. مثلًا، صف تغيرًا في الإضاءة أو الخلفية ضمن جزء واحد بدل طلب إعادة تصميم الفيلم كاملًا. بعد التحرير، افحص اللحظات السابقة للفترة واللاحقة لها مع المحتوى المعدّل.
المخرج السمعي البصري والإبداع متعدد اللغات تصف مواصفات المنتج لدى الجهة المنتجة توليدًا من 4–30 ثانية بدقة 480p أو720p أو1080p، وبمعدل 24 FPS، مع إخراج MP4 أوMOV. وتصف المقدمة الرسمية دعمًا أصليًا لأكثر من 10 لغات وإنشاءً تقوده الحوارات. هذه قدرات وخيارات صيغ للشركة المصنّعة؛ ولا تحدد عقد Ailoot لمدخلات الملفات أو المدة أو صيغة الإخراج. ولعمل يقوده الحوار، حدّد الكلام المقصود وعلاقته بالفعل، ثم اطلب مراجعة الصياغة والنطق من متحدث متقن قبل استخدام نسخة موطّنة.
التطبيقات والحدود الجوهرية يفيد النموذج في مفاهيم الحملات وعروض المنتجات والقصص التي تقودها شخصيات والمعاينات الواقعية من لقطات مرجعية أو تنظيم ثلاثي الأبعاد بسيط. وتعرض الشركة المصنّعة أيضًا شروحات تعليمية وتصورات للتصنيع أو التجميع. وما زالت اللقطات الإرشادية أو المحاكاة المولّدة تحتاج إلى مراجعة وفق العملية الحقيقية المعروضة. ويحدد الإصدار صراحة فيزياء الحركة المعقدة والتفاعلات المستقرة بين عناصر متعددة داخل المشهد مجالات للتحسين. افحص تماس الأيدي والأشياء وتفاعلات المجموعة ومسارات الحركة واتساق الشخصيات وتوقيت الصوت مع الصورة عبر المقطع كاملًا. لا يثبت إطار افتتاحي قوي أن التسلسل الكامل يتبع المتطلبات.
Ailoot Ultra · فيديو POST /v1/videos bytedance/seedance-2.5
bytedance/seedance-2.5البداية
ينشئ Seedance 2.5 الصوت والفيديو معًا لمشاهد أطول ومراجع غنية بالصور والفيديو والصوت وتعديلات محددة. توثّق ByteDance Seed توليدًا حتى 30 ثانية وتوجيهًا برندر طيني وتحكّمًا في الكاميرا واستكمال اللقطات الموجودة.
- المدخلات المقبولة
- النص · الصور · الصوت
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image,audio- الإخراج
video- صيغة الإخراج
- بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود bytedance/seedance-2.5 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 الحد الأدنى: 1 الحد الأقصى: 600 | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480p, 720p | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | القيمة الافتراضية— |
الحقلgenerate_audio | النوعboolean | المتطلباختياري | القيم والحدود false, true الشروط: يؤدي حذف generate_audio إلى اختيار السعر الذي يتضمن الصوت؛ وتختار القيمة false السعر دون صوت. افحص has_audio في النتيجة لمعرفة ما إذا أُعيد مسار صوتي. | القيمة الافتراضية— |
الحقلframe_images | النوعarray | المتطلباختياري | القيم والحدود الحد الأدنى للعناصر: 1 الحد الأقصى للعناصر: 2 محتوى الإدخال: مصفوفة من كائنات الإطارات. يحتوي كل منها على type=image_url وimage_url الذي يحتوي على url، وعلى frame_type=first_frame أو last_frame. لا يتكرر كل دور أكثر من مرة. استخدم عناوين URL عامة عبر HTTPS. المفاتيح الدقيقة: type, image_url, frame_type الشروط: تنطبق هذه المفاتيح على كل كائن إطار. احذف frame_images في الطلبات النصية فقط. | القيمة الافتراضية— |
الحقلinput_references | النوعarray | المتطلباختياري | القيم والحدود محتوى الإدخال: مصفوفة كائنات لمراجع الصور أو الصوت. اضبط type على image_url أو audio_url، وقدّم كائن URL المطابق الذي يحتوي على url. تظل مراجع الفيديو غير قابلة للتسعير. الشروط: احذف frame_images لاستخدام نمط المراجع. استخدم عناوين URL عامة عبر HTTPS. | القيمة الافتراضية— |
الحقلsize | النوعstring | المتطلباختياري | القيم والحدود 854x480, 752x560, 640x640, 560x752, 480x854, 992x432, 1280x720, 1112x834, 960x960, 834x1112, 720x1280, 1470x630 النمط: ^[1-9][0-9]*x[1-9][0-9]*$ الشروط: بالنسبة إلى المقاسات المدرجة غير 1280x720، احذف aspect_ratio. يمكنك الجمع بين 1280x720 و16:9. إذا قدّمت resolution، فيجب أن يطابق شريحة 480p أو 720p الخاصة بالمقاس المختار. | القيمة الافتراضية— |
الحقلseed | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: -9,223,372,036,854,775,808 الحد الأقصى: 9,223,372,036,854,775,807 | القيمة الافتراضية— |
الحقلcallback_url | النوعstring | المتطلباختياري | القيم والحدود النمط: ^https:// | القيمة الافتراضية— |
الحقلsession_id | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلtrace | النوعobject | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلuser | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى فيديو · موجّه نصي. · مطلوب: model, prompt, duration
قدّم موجّهاً نصياً ومدة مدعومة بعدد صحيح من الثواني. استخدم مقاساً دقيقاً مدرجاً، أو دقة ونسبة أبعاد تحددان أبعاداً مدرجة.
model: النوع: string · bytedance/seedance-2.5
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
تحويل الصورة إلى فيديو · موجّه نصي وصورة إطار. · مطلوب: model, prompt, duration, frame_images
الحقل frame_images مصفوفة كائنات تحتوي على type=image_url وimage_url الذي يحتوي على url، وعلى frame_type. استخدم عنوان URL عاماً لصورة عبر HTTPS؛ ويمكن أن يظهر كل من first_frame وlast_frame مرة واحدة. استخدم مقاس مخرجات مدرجاً أو أبعاداً متوافقة. لا تضف مراجع فيديو.
المفاتيح الدقيقة: type, image_url, frame_type
model: النوع: string · bytedance/seedance-2.5
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
Reference to video · موجّه نصي ومراجع صور أو صوت. · مطلوب: model, prompt, duration, input_references
الحقل input_references مصفوفة. يحتوي كل كائن على type=image_url أو type=audio_url وعلى كائن URL مطابق يحتوي على url. استخدم روابط HTTPS عامة. احذف frame_images لاختيار نمط المراجع. لا يمكن تسعير مراجع الفيديو.
model: النوع: string · bytedance/seedance-2.5
prompt: النوع: string · الحد الأقصى لبايتات UTF-8: 10,000 · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, duration |
المعلمةmaterial_types | المواصفاتtext, image, audio |
المعلمةadditional_properties | المواصفاتfalse |
المعلمةoptional_controls | المواصفاتresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
دورة الحياة: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | وحدة الفوترة | شروط الفوترة | الرسوم |
|---|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0214 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالمدخل: with_video_input | الرسوم reference · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0128 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0214 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.822402 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر توكن الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر توكن الفيديو $0.0214 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر توكن الفيديو $0.0214 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالمدخل: with_video_input | الرسوم reference · سعر توكن الفيديو $0.0128 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
أمثلة للطلبات
Ailoot Ultra · فيديو
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.5","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"854x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
استلام النتائج وحفظها
Ailoot Ultra · فيديو
عناوين URL موقّعة لمحتوى مملوك لك
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
التحقق من حالة المهمة
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
عمليات أخرى لقراءة المحتوى
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل مخرج فعلي مملوك لك وبالبيانات الوصفية المقاسة المُعادة معه.
عند الحاجة إلى التحقق من الاستجابة الأصلية
503 result_pending_check + المعرّف الأصلي + X-Should-Retry:false؛ لا تعِد تنفيذ العملية الأصلية مطلقاً
حقول الاستجابة
| الحقل | النوع | المعنى |
|---|---|---|
الحقلindex | النوعinteger | المعنىموضع هذا الفيديو في قائمة المخرجات، بدءاً من الصفر. |
الحقلcontent_url | النوعstring | المعنىعنوان URL موقّع عبر HTTPS لتنزيل هذا الفيديو المكتمل. |
الحقلsha256 | النوعstring | null | المعنىبصمة SHA-256 لبايتات الفيديو الأصلي؛ وتكون القيمة null إذا لم تتوفر. |
الحقلsize_bytes | النوعinteger | null | المعنىحجم ملف الفيديو الأصلي بالبايت؛ وتكون القيمة null إذا لم يتوفر. |
الحقلduration_ms | النوعinteger | null | المعنىمدة الفيديو المقاسة بالمللي ثانية؛ وتكون القيمة null إذا لم تتوفر. |
الحقلwidth | النوعinteger | null | المعنىعرض الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
الحقلheight | النوعinteger | null | المعنىارتفاع الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
الحقلvideo_codec | النوعstring | null | المعنىمعرّف ترميز الفيديو؛ وتكون القيمة null إذا لم يُسجَّل. |
الحقلhas_audio | النوعboolean | null | المعنىما إذا كان الفيديو يحتوي على مسار صوتي؛ وتكون القيمة null إذا لم يُقَس ذلك. |
الحقلaudio_codec | النوعstring | null | المعنىمعرّف ترميز الصوت؛ وتكون القيمة null إذا لم يُسجَّل معرّف. |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة404 · not_found_error | الشرطالوصول إلى الفيديو غير متاح، أو لم يُعثر على معرّف الفيديو هذا. | الخطوة التاليةتحقق من الوصول إلى الفيديو. للفيديو الموجود، استخدم معرّفه العام الأصلي ومفتاح API نفسه. |
الاستجابة401 · authentication_error | الشرطمفتاح API لا يطابق الحساب الذي تمت المصادقة عليه. | الخطوة التاليةتحقق من مفتاح API وإمكانية وصول حسابك قبل الإرسال. |
الاستجابة400 · invalid_request_error | الشرطتعذرت قراءة الطلب، أو فهرس التنزيل غير صالح. | الخطوة التاليةصحّح متن الطلب. للتنزيل، اختر فهرس مخرج أعادته المهمة الأصلية. |
الاستجابة422 · price_unavailable | الشرطيتعذر تسعير إعداد الفيديو المختار. | الخطوة التاليةاختر إعداد فيديو مدعوماً وأكمل خياراته المطلوبة قبل إرسال طلب مصحح. |
الاستجابة422 · invalid_request_error | الشرطإدخال الفيديو أو مهمة المتابعة الأصلية غير صالح. | الخطوة التاليةاستخدم مدخلات HTTPS صالحة. للمتابعة، استخدم المعرّف العام للفيديو الأصلي المكتمل لديك مع مفتاح API نفسه. |
الاستجابة402 · billing_error | الشرطالرصيد المتاح أو الحدود المقررة لا تسمح بحجز الرصيد. | الخطوة التاليةتحقق من رصيدك المتاح وحدودك قبل إرسال طلب جديد. |
الاستجابة503 · server_error | الشرطالتحقق من الفيديو أو التخزين أو الوصول إلى الخدمة غير متاح مؤقتاً. | الخطوة التاليةانتظر إتاحة الخدمة. إذا كان لديك معرّف فيديو بالفعل، فتحقق من تلك المهمة الأصلية بدلاً من إنشاء عملية توليد أخرى. |
الاستجابة503 · result_pending_check | الشرطتحتاج نتيجة الفيديو الأصلية والرسم المحتسب إلى التحقق. | الخطوة التاليةاحتفظ بمعرّف الفيديو المُعاد وتحقق من تلك المهمة. لا ترسل طلب توليد بديل أثناء التحقق منها. |
الاستجابة503 · owned_result_unavailable | الشرطتنزيل الفيديو الموجود غير متاح مؤقتاً. | الخطوة التاليةتحقق من مهمة الفيديو نفسها لاحقاً ونزّل مخرجها الموجود. ينشئ التوليد الجديد عملية منفصلة. |
الاستجابة409 · video_not_ready | الشرطلم يُنشر محتوى الفيديو. | الخطوة التاليةتحقق من حالة المهمة الأصلية. نزّل المخرجات بعد أن تُبلِغ عن completed؛ وإذا أبلغت عن failed، فاتبع إشعارها المتعلق بالتحقق من الرسم المحتسب. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra bytedance/seedance-2.5
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · ByteDance: Seedance 2.5
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·bytedance/seedance-2.5:text,image,audio→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·bytedance/seedance-2.5:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- ما الحدود المطبقة؟
POST /v1/videos·bytedance/seedance-2.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807