ByteDance: Seedance 2.0
يجمع ByteDance Seedance 2.0 بين التوليد الأصلي للصوت والفيديو ومراجع الصور والفيديو والصوت. أخرج مشاهد جديدة أو حرّر لقطات موجودة أو مدّد تسلسلًا؛ ويتضمن الإصدار القياسي إخراجًا موثّقًا بدقة 1080p و4K بعمق 10-bit.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Seedance 2.0 هو نموذج ByteDance Seed القياسي لإنشاء الصوت والفيديو متعدد الوسائط. يجمع النص والصور والفيديوهات والصوت في بنية توليد مشتركة، مع مسارات إبداعية منفصلة للمشاهد التي تقودها المراجع وتحرير الفيديو وتمديده. يفيد عندما تتطلب المهمة أداءً مترابطًا ومعلومات بصرية أو صوتية محددة من مواد مُعدّة.
المرجع متعدد الوسائط والتحكّم الإخراجي
يمكن للصور تحديد مظهر الموضوع والأسلوب البصري والتكوين. ويمكن للمراجع المرئية توجيه الفعل وحركة الكاميرا والتأثيرات. ويمكن للصوت توجيه طابع الصوت أو الموسيقى أو الحوار. حدّد دور كل مادة، ثم صف المشهد المطلوب. وتؤكد الشركة المصنّعة التحكّم في الأداء والإضاءة والظلال واللغة السينمائية.
لقصة منتج، أعدّ صورة المنتج ومرجع حركة الكاميرا وإشارة صوتية. وقد تكون المتطلبات: «حافظ على المزهرية الزجاجية الزرقاء من Image 1. استخدم حركة التتبع الجانبية البطيئة من Video 1. تقف المزهرية على رف مضاء بالشمس، مع موسيقى آلية هادئة مستندة إلى Audio 1.» المخرج المقصود مشهد منظّم جديد يجمع معلومات مختارة من المراجع.
يمكن لمدخلات المراجع الجمع بين الصورة والصوت أو الصورة والفيديو أو الفيديو والصوت أو الأنواع الثلاثة. ولا يُدعم إدخال الصوت وحده أو النص مع الصوت دون صورة أو فيديو. ويوثّق أيضًا التحويل التقليدي للنص إلى فيديو والتوليد بإطار أول وبإطارين أول وأخير. وإذا كانت التكوينات الافتتاحية والختامية الثابتة مهمة، فاستخدم مسار النهايات المخصص: فتسمية صورة مرجعية نهايةً داخل توجيه مرجع شامل ليست إلا وسيلة غير مباشرة لتوجيهها.
تحرير اللقطات
يستطيع النموذج استبدال موضوع وإضافة الأشياء أو إزالتها وتغيير العناصر وإعادة رسم أجزاء فيديو أو إصلاحها. صف التغيير المحدد وعرّف اللقطات المصدر. وللإضافة، ضمّن وقت الظهور وموضعه؛ وللإزالة أو الاستبدال، حدّد الشيء بدقة وسمّ ما ينبغي أن يبقى.
مثلًا: «استبدل مصباح المكتب في Video 1 بالمصباح النحاسي في Image 1. حافظ على حركة الكاميرا وترتيب المكتب واتجاه الإضاءة.» النتيجة المطلوبة نسخة محررة من المشهد بالاستبدال المقصود. افحص المناطق غير المتغيرة والشيء الجديد معًا، خصوصًا عبر الاحتجاب والحركة وتغير اللقطات.
تمديد التسلسل ووصله
يمكن لـSeedance 2.0 تمديد فيديو إلى الأمام أو الخلف ووصل حتى ثلاثة مقاطع مقدّمة بانتقالات مولّدة. حدّد الاتجاه الزمني والحدث الجديد. وللجسر، رتّب المقاطع وصف الانتقال بين كل زوج، مثل دخول الكاميرا بابًا في لقطة ووصولها إلى البيئة التالية.
يعيد التمديد المباشر عادة الاستكمال المطوّر حول اللقطات المصدر؛ أدرج تعليمة واضحة إذا كان ينبغي أن تعيد النتيجة النهائية أيضًا الجزء الأصلي. وعند إكمال وصلة بين مقطعين أو ثلاثة، يستطيع المسار الموثّق تضمين المادة الأصلية ومحتوى انتقال جديد. يفيد ذلك تطوير افتتاح أو ختام أو وصل مشاهد مُعدّة دون ترك فعل الربط غير محدد.
إخراج الإصدار القياسي و4K
يوثّق الإصدار القياسي MP4 بمعدل 24 fps ومددًا من 4 إلى 15 ثانية. مستويات الإخراج هي 480p و720p و1080p بعمق لون 8-bit، إضافة إلى 4K بعمق لون 10-bit. والنسب المدعومة 21:9 و16:9 و4:3 و1:1 و3:4 و9:16. ويوثّق أيضًا التأطير التكيفي والاختيار التلقائي للمدة. ولإصدار Fast مواصفات إخراج أضيق خاصة به بدقة 480p/720p.
يستخدم إخراج 4K ترميز H.265/HEVC. ويحفظ ترميز عشرة بتات تدرجات نغمية إضافية وانتقالات لونية أنعم، وهو مهم للمادة ذات تدرجات الضوء أو اللون الدقيقة. تحقّق من قدرة بيئة التشغيل والتحرير المقصودة على فك ذلك التنسيق؛ فبعض المتصفحات والأجهزة لا تشغله مباشرة. والحاوية المتوافقة لا تضمن وحدها توافق فك ترميز الفيديو.
يمكن للنموذج توليد صوت متزامن أو فيديو صامت، وإعادة آخر إطار مولّد لمشهد تالٍ. الصوت المولّد أحادي القناة. ولا تدعم عائلة 2.0 وضع معاينة Draft المنفصل ذي المرحلتين، لذلك لا ينبغي استنتاج ميزة المعاينة تلك من إصدار Seedance آخر.
إعداد المراجع والحدود الجوهرية
السعة المرجعية الموثّقة حتى تسع صور وثلاثة فيديوهات وثلاثة مقاطع صوت. لا تُقبل صور أو فيديوهات مرجعية مرفوعة مباشرة تتضمن وجوه بشر حقيقيين في نمط الجهة المنتجة الموثّق هذا؛ ويستخدم العمل على الصور الشخصية مسار المواد الشخصية المدعوم. يجب أن تكون مدة كل مقطع فيديو وصوت 2–15 ثانية. يجب أن تقع جميع مراجع الفيديو ضمن إجمالي 15 ثانية، ولجميع المراجع الصوتية إجمالي مستقل قدره 15 ثانية. تستخدم ملفات الفيديو MP4 أوMOV عند 24–60 fps وحتى 200 MB لكل منها؛ وتستخدم الملفات الصوتية WAV أوMP3 وحتى 15 MB لكل منها. صيغ الصور المدرجة هي JPEG وPNG وWebP وBMP وTIFF وGIF وHEIC وHEIF. يجب أن تكون الصور أصغر من 30 MB لكل منها، وألا يتجاوز جسم الطلب 64 MB. وفي مواصفات إدخال المراجع الموثّقة، يجب أن يكون عرض الصورة وارتفاعها أكبر من 300 وأقل من 6,000 بكسل حصرًا، ونسبة العرض إلى الارتفاع أكبر من 0.4 وأقل من 2.5 حصرًا. تسمح الفيديوهات المرجعية بـ300–6,000 بكسل في كل بُعد ونسب 0.4–2.5 شاملًا الحدين، مع إجمالي 407,696–8,295,044 بكسل. تستخدم فيديوهات MP4 أوMOV ترميز H.264/AVC أوH.265/HEVC وصوت AAC أوMP3.
رتّب الملفات بعناية وأشر إلى كل منها بنوع وسائطه ورقمه: Image 1 وVideo 1 وAudio 1. يتبع الرقم الترتيب بين ملفات النوع نفسه. اشرح الصفات المطلوب نقلها ومحتوى المصدر الذي لا ينبغي أن يحدد المشهد الجديد. تشمل لغات التوجيه الموثّقة الإنجليزية والإسبانية والإندونيسية والبرتغالية واليابانية. حافظ على لغة الكلام نفسها داخل الحوار؛ وينصح الدليل بتجنب مزج اللغات إلا للأسماء العلم. وللعمل الموجّه بالصوت، افصل المتحدث والعبارة الدقيقة وتوجيه الإلقاء.
أعدّ الصورتين الأولى والأخيرة بتأطير متوافق. يمكن لعدم تطابق الصورة المدخلة وأبعاد الإخراج أن يسبب اقتطاعًا أو تغيرًا بصريًا مفاجئًا؛ وتُوثّق مطابقة الأبعاد والتأطير التكيفي بوصفهما حلين. ركّز الوصف على الحدث وأدوار المراجع. تحذّر الشركة المصنّعة من تشتيت المعلومات في التوجيهات الطويلة بما يسبب تجاهل التفاصيل. راجع الحركة الناتجة واستمرارية المراجع والأداء الصوتي والوصلات بين المشاهد بوصفها أجزاء منفصلة من النتيجة الإبداعية.
تخطيط اللقطات وتوجيه النص
لمشهد معقد، نظّم المتطلبات في Shot 1 وShot 2 وShot 3، محددًا الكاميرا وفعل الموضوع وموضعه والصوت بالترتيب. يوصي الدليل بحركة كاميرا واحدة لكل لقطة وتفضيل الأفعال البطيئة المترابطة. الطوابع الزمنية الدقيقة لكل لقطة غير مستقرة، لذا يوفر تسلسل الأحداث تحكّمًا أفضل من فرض عدة فترات دقيقة.
يولّد النموذج أيضًا نصًا شائعًا، مثل الشعارات الإعلانية والترجمات وفقاعات الكلام. يمكنك توجيه اللون والمعالجة البصرية والموضع والدخول. استخدم المحارف الشائعة بدل النادرة أو الرموز الخاصة، وراجع الصياغة أثناء حركتها. وللمراجع الخاصة بالعناصر المصوّرة، اربط كل مادة بوضوح بالشخصية أو الشيء المقصود. تستطيع زوايا المنتج تقديم معلومات بصرية مختلفة؛ وقد تربك اللوحات المجمّعة التي تعرض الشخصية من زوايا متعددة هوية الوجه. والتوصية الموثّقة لمرجع الشخصية صورة وجه واضحة وصورة جسم كامل منفصلتان.
السلوكيات المطلوب فحصها قبل التحرير
يوثّق الدليل ترجمات وشعارات غير مرغوبة وشخصيات مكررة وانجراف الأسلوب. تقلل المواد المصدر النظيفة والتسميات المتسقة والقيود الصريحة هذه المخاطر، لكنها لا تضمن اختفاء النص أو الشخصيات المكررة غير المرغوبة. ويُذكر وجود أكثر من أربعة أشخاص مرجعيين خطرًا على الاستقرار، منفصلًا عن عدد الملفات المقبولة.
قد يسبب تمديد الفيديو قفزة أو تراجعًا عند الوصلة، وقد تراكم الاستكمالات المتكررة تدهور جودة الصورة. افحص الإطارات الحدودية وقلّل التمديدات المتراكبة. وقد يختلف الصوت المرجعي عن طابع المصدر؛ وقد ينتهي السرد بنقرة أو قطع مفاجئ، ويُوثّق التلاشي الصوتي علاجًا لذلك. ويمكن نطق المحارف الصينية متعددة القراءة أو غير الشائعة أو متشابهة الشكل بصورة خاطئة. ولتأثير متحرك دقيق، مثل العد التنازلي، يكون مرجع حركة أكثر إفادة من طلب لفظي وحده. هذه أسباب ملموسة لفحص الهوية والنص والحركة والصوت منفصلة عند اختيار المقطع.
Ailoot Ultra · فيديو POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0البداية
يجمع ByteDance Seedance 2.0 بين التوليد الأصلي للصوت والفيديو ومراجع الصور والفيديو والصوت. أخرج مشاهد جديدة أو حرّر لقطات موجودة أو مدّد تسلسلًا؛ ويتضمن الإصدار القياسي إخراجًا موثّقًا بدقة 1080p و4K بعمق 10-bit.
- المدخلات المقبولة
- النص · الصور · الصوت
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image,audio- الإخراج
video- صيغة الإخراج
- بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود bytedance/seedance-2.0 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 الحد الأدنى: 1 الحد الأقصى: 600 | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480p, 720p, 1080p, 4K | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | القيمة الافتراضية— |
الحقلgenerate_audio | النوعboolean | المتطلباختياري | القيم والحدود false, true الشروط: عند 480p و720p، يؤدي حذف generate_audio إلى اختيار السعر الذي يتضمن الصوت، وتختار القيمة false السعر دون صوت. عند 1080p و4K، يُطبَّق سعر الدقة في كلا الإعدادين. افحص 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 | المتطلباختياري | القيم والحدود 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 النمط: ^[1-9][0-9]*x[1-9][0-9]*$ | القيمة الافتراضية— |
الحقل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.0
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.0
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.0
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.014 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةresolution: 1080p | الرسوم الإخراج · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0154 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالمدخل: with_video_input؛ الدقة: 1080p | الرسوم reference · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0094 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةresolution: 4k | الرسوم الإخراج · سعر توكن الفيديو · تقدير للمقارنة فقط $0.008 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالمدخل: with_video_input؛ الدقة: 4k | الرسوم reference · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0048 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالمدخل: with_video_input | الرسوم reference · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0086 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر توكن الفيديو · تقدير للمقارنة فقط $0.014 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.3024 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر توكن الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر توكن الفيديو $0.014 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةresolution: 4k | الرسوم الإخراج · سعر توكن الفيديو $0.008 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةresolution: 1080p | الرسوم الإخراج · سعر توكن الفيديو $0.0154 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر توكن الفيديو $0.014 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالمدخل: with_video_input | الرسوم reference · سعر توكن الفيديو $0.0086 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالمدخل: with_video_input؛ الدقة: 4k | الرسوم reference · سعر توكن الفيديو $0.0048 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالمدخل: with_video_input؛ الدقة: 1080p | الرسوم reference · سعر توكن الفيديو $0.0094 لكل 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.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","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.0
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · ByteDance: Seedance 2.0
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·bytedance/seedance-2.0: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.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807