ByteDance: Seedance 2.0 Fast
ينشئ ByteDance Seedance 2.0 Fast مشاهد صوت وفيديو من النص والصور والفيديو ومراجع الصوت. يدعم إصداره الموجه للسرعة نقل الحركة والأسلوب وتعديلات الفيديو والتمديد إلى الأمام أو الخلف، مع إخراج موثّق بدقة 480p و720p.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Seedance 2.0 Fast هو إصدار ByteDance Seed الموجه للسرعة من عائلة Seedance 2.0. يدعم توليد الفيديو والصوت معًا ومتطلبات متعددة الوسائط تتكون من النص والصور والفيديو والصوت. وتشمل قدراته الإبداعية مشاهد جديدة تقودها المراجع وتعديلات للقطات موجودة وتمديد المشهد، بينما مستويا الإخراج الموثّقان هما 480p و720p.
المرجع متعدد الوسائط: إسناد الأدوار للمواد
يمكن للصورة تقديم شخصية أو منتج أو تكوين أو معالجة بصرية. ويمكن للفيديو المرجعي تقديم الفعل أو حركة الكاميرا أو تأثير. ويمكن للصوت المرجعي تقديم طابع صوت أو لحن موسيقي أو محتوى حوار. اشرح الجزء الذي تريد نقله من كل مصدر إلى المشهد الجديد؛ فالمرجع أنفع عندما يكون له دور إبداعي محدد.
مثلًا: «استخدم المصباح الخزفي في Image 1 بوصفه المنتج. اتبع دوران الكاميرا البطيء في Video 1، لكن ضع المصباح في ركن قراءة هادئ. استخدم Audio 1 للمزاج الموسيقي.» المخرج المقصود مشهد جديد يجمع المظهر والحركة والتوجيه الصوتي المختارة، بدل محاكاة غير محددة لكل تفاصيل المراجع.
تشمل التركيبات الموثّقة الصور مع الصوت، والصور مع الفيديو، والفيديو مع الصوت، والأنواع الثلاثة معًا. النص مع الصوت وحده، والإدخال الصوتي فقط، غير مدعومين. ويدعم النموذج أيضًا النص إلى فيديو والتوليد الذي تقوده صورة من إطار أول أو زوج إطار أول وأخير. عندما تكون نقطة نهاية دقيقة محورية، استخدم مسار النهايات المخصص؛ فوصف صورة مرجعية بأنها نهاية في توجيه مرجع شامل تحكّم غير مباشر.
تحرير فيديو موجود
يستطيع النموذج إضافة عناصر أو إزالتها أو تعديلها واستبدال موضوع وإعادة رسم أجزاء مشهد أو إصلاحها. حدّد الفيديو المصدر والشيء المطلوب تغييره والعناصر التي يجب أن تبقى. وللإضافة، صف مكان الظهور ووقته. وللإزالة، عرّف الشيء باتساق طوال المقطع.
قد تستبدل متطلبات تحرير عملية زجاجة عادية في عرض بالزجاجة من Image 1، مع طلب الحفاظ على حركة اليد والخلفية ومسار الكاميرا في Video 1. راجع الاستبدال والمناطق المطلوب أن تبقى ثابتة معًا. تجعل تعليمات الحفظ الواضحة التحرير المقصود أسهل تقييمًا من طلب عام لـ«تحسين» اللقطات.
تمديد المقاطع ووصلها
يدعم Seedance 2.0 Fast التمديد إلى الأمام أو الخلف ووصل مقطعين أو ثلاثة بانتقالات مولّدة. وللتمديد، حدّد إن كان الفعل الجديد يقع قبل الفيديو المقدّم أو بعده وصف ذلك الفعل. وللوصل، قدّم المقاطع بترتيبها المقصود واشرح الحدث البصري الذي يصل بينها.
يعيد التمديد البسيط عادة الاستكمال المطوّر حديثًا حول اللقطات الأصلية، بدل افتراض إعادة المقطع المصدر كاملًا. وإذا كان يجب أن يحوي المخرج الجزء الأصلي، فاذكر ذلك في المتطلبات. وعند ملء انتقال بين فيديوهين أو ثلاثة، يمكن للمسار الموثّق الجمع بين محتوى أصلي وآخر مولّد حديثًا. يفيد ذلك وصل منظر واسع لمنتج بلقطة تفصيل عبر حركة كاميرا هادفة.
الإخراج واختلافات الإصدار
إخراج Fast الموثّق هو MP4 بمعدل 24 fps ودقة 480p أو720p وعمق لون 8-bit ومقاطع مدتها 4–15 ثانية. النسب المدعومة هي 21:9 و16:9 و4:3 و1:1 و3:4 و9:16. ويسرد إصدار Seedance 2.0 القياسي بصورة منفصلة إخراج 1080p و4K؛ ولا تدخل تلك المستويات ضمن مواصفات Fast. تدعم عائلة 2.0 إعادة آخر إطار مولّد، لكنها لا تدعم وضع معاينة Draft المنفصل.
يمكن توليد الصوت مع اللقطات أو حذفه لمقطع صامت. والصوت المولّد أحادي القناة. تشمل لغات التوجيه الموثّقة الإنجليزية والإسبانية والإندونيسية والبرتغالية واليابانية. حافظ على لغة الكلام نفسها داخل الحوار؛ وينصح الدليل بتجنب مزج اللغات إلا للأسماء العلم. ولمشهد منطوق، سمّ المتحدث وضع عبارته بين علامتي اقتباس، ثم حدّد الإلقاء والمؤثرات الصوتية ذات الصلة. اجعل الأداء المطلوب مناسبًا لطول المقطع المختار.
إعداد المراجع ومراعاة حدود الإدخال
حدود المراجع الموثّقة هي حتى تسع صور وثلاثة فيديوهات وثلاثة مقاطع صوت. لا يقبل نمط الجهة المنتجة الموثّق هذا رفع صور أو فيديوهات مرجعية مباشرة تضم وجوه بشر حقيقيين؛ ويستخدم العمل على الصور الشخصية مسار المواد الشخصية المدعوم. يجب أن تكون مدة كل مقطع فيديو أو صوت 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-fast
bytedance/seedance-2.0-fastالبداية
ينشئ ByteDance Seedance 2.0 Fast مشاهد صوت وفيديو من النص والصور والفيديو ومراجع الصوت. يدعم إصداره الموجه للسرعة نقل الحركة والأسلوب وتعديلات الفيديو والتمديد إلى الأمام أو الخلف، مع إخراج موثّق بدقة 480p و720p.
- المدخلات المقبولة
- النص · الصور · الصوت
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image,audio- الإخراج
video- صيغة الإخراج
- بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود bytedance/seedance-2.0-fast | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 الحد الأدنى: 1 الحد الأقصى: 600 | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480p, 720p | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | القيمة الافتراضية— |
الحقل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 | المتطلباختياري | القيم والحدود 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720 النمط: ^[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-fast
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-fast
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-fast
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.0084 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالمدخل: with_video_input | الرسوم reference · سعر توكن الفيديو · تقدير للمقارنة فقط $0.00495 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر توكن الفيديو · تقدير للمقارنة فقط $0.0084 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.18144 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر توكن الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر توكن الفيديو $0.0084 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر توكن الفيديو $0.0084 لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالمدخل: with_video_input | الرسوم reference · سعر توكن الفيديو $0.00495 لكل 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-fast","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-fast
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · ByteDance: Seedance 2.0 Fast
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·bytedance/seedance-2.0-fast:text,image,audio→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·bytedance/seedance-2.0-fast: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-fast:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807