Source: https://ailoot.ai/models/ar/bytedance-seedance-2-0-mini/
Canonical: https://ailoot.ai/models/ar/bytedance-seedance-2-0-mini/
Language: ar

# ByteDance: Seedance 2.0 Mini

[Markdown](https://ailoot.ai/models/ar/bytedance-seedance-2-0-mini/index.md) · [JSON](https://ailoot.ai/models/ar/bytedance-seedance-2-0-mini/facts.json)

## [ByteDance: Seedance 2.0 Mini](https://ailoot.ai/models/ar/bytedance-seedance-2-0-mini/)

ينشئ Seedance 2.0 Mini فيديوهات قصيرة بصوت مولّد اختياريًا من النص والصور ومراجع الفيديو والصوت. يدعم إنشاء المشاهد وتعديلات الفيديو المحددة والاستكمال، مع مواصفات إخراج موثّقة بدقة 480p أو720p.

- [**Ailoot Ultra · فيديو** `POST /v1/videos` `bytedance/seedance-2.0-mini`](https://ailoot.ai/models/ar/bytedance-seedance-2-0-mini/#method-0)

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Seedance 2.0 Mini هو نموذج مسمّى بصورة منفصلة في عائلة ByteDance Seedance 2.0 السمعية البصرية. توثّق الشركة المصنّعة تحويل النص إلى فيديو، والصورة إلى فيديو بإطار أول أو بإطارين أول وأخير، والتوليد بمراجع متعددة الوسائط، وتحرير الفيديو وتمديده. ويمكن توليد الصوت مع الصورة. اختر وضع الإنشاء وفق المادة الموجودة لديك: متطلبات مكتوبة أو صورة افتتاحية ثابتة أو إطاران حدوديان أو مقطع يحتاج إلى تحرير أو استكمال.

لـMini مواصفات إخراج خاصة. تسرد الشركة المصنّعة فيديو بدقة 480p و720p وعمق لون 8-bit ومعدل 24 إطارًا في الثانية وإخراج MP4. ونسب العرض المدعومة هي 21:9 و16:9 و4:3 و1:1 و3:4 و9:16؛ والمدة الموثّقة للتوليد 4–15 ثانية. ويتيح إعداد المدة لدى الجهة المنتجة أيضًا اختيارًا تلقائيًا ضمن هذا النطاق. خيارات 1080p و4K في نموذج Seedance 2.0 الكامل منفصلة؛ وليست إعدادات Mini. يسرد جدول قدرات العائلة إعادة آخر إطار مولّد، بينما وضع Draft غير مدعوم.

ينشئ المرجع الشامل مشهدًا جديدًا باستخدام معلومات مختارة من المادة المقدّمة. يمكن للصورة تحديد مظهر موضوع أو تكوينه أو معالجته البصرية. ويمكن للفيديو تحديد الفعل أو حركة الكاميرا أو تأثير؛ وللمرجع الصوتي تحديد طابع الصوت أو اللحن أو المحتوى المنطوق. أخبر النموذج بما يأخذه من كل مرجع بدل مطالبته بنسخ كل الخصائص. مثلًا، استخدم صورة منتج للشكل واللون، ومقطع حركة كاميرا قصيرًا للاقتراب، ومرجعًا صوتيًا للأجواء.

يتيح سير عمل العائلة حتى تسع صور مرجعية وثلاثة مقاطع فيديو وثلاثة مقاطع صوت. مدة كل مرجع فيديو 2–15 ثانية، بإجمالي لا يتجاوز 15 ثانية؛ وتستخدم المراجع الصوتية حدود المدة نفسها لكل مقطع وللإجمالي. الصوت وحده والنص مع الصوت دون مرجع بصري تركيبتان غير مدعومتين للمراجع. والإنشاء بالنص وحده وضع مدعوم منفصل. ولتسلسل، قدّم المواد بالترتيب المقصود وأشر إليها باتساق باسم Image 1 أوVideo 1 أوAudio 1، باستخدام ترتيب كل نوع وسائط على حدة. لا تستبدل معرّف مادة بالمرجع المرقّم في التوجيه المكتوب.

تحدد صورة الإطار الأول افتتاح لقطة تقودها صورة. ويحدد وضع الإطارين الأول والأخير الحدين معًا. إذا كانت الصورتان الحدوديتان الدقيقتان مهمتين، فاختر ذلك الوضع المخصص بدل وصف المراجع بأنها افتتاح وختام داخل توجيه مرجع شامل. فالأخير تأثير موجّه بالنص ولا يعادل اختيارًا صارمًا لإطارات حدودية. أعدّ الصور لتكوين الإخراج وحدّد الفعل الذي يصل حالتي البداية والنهاية.

يغيّر تحرير الفيديو مقطعًا موجودًا بدل استخدامه للإلهام فقط. حدّد الفيديو المطلوب تحريره والشيء أو المنطقة المطلوب تغييرها ووقت ظهورها وموضعها والتفاصيل المطلوب الحفاظ عليها. ومن المتطلبات المفيدة: «في Video 1، استبدل الكوب بالوعاء الموضح في Image 1؛ حافظ على حركة اليد والتأطير والإضاءة وترتيب الطاولة.» وللإزالة، سمّ الشيء غير المرغوب والعناصر المحيطة التي يجب أن تبقى. تنصح الشركة المصنّعة بالإشارة مباشرة إلى الفيديو المستهدف للتحرير أو التمديد؛ فوصفه مرجعًا قد يوصل بدلًا من ذلك طلبًا لمشهد مولّد جديد.

يضيف تمديد الفيديو أحداثًا قبل مقطع موجود أو بعده. صف اتجاه الاستكمال وما يحدث لاحقًا أو سابقًا. ويمكن لسير العمل الموثّق أيضًا وصل مقطعين أو ثلاثة بانتقالات مولّدة؛ وتظل الفيديوهات الثلاثة المدخلة معًا ضمن ميزانية المراجع البالغة 15 ثانية. يميّز الدليل التعليمي استكمالًا يتضمن أساسًا اللقطات الحدودية للمقطع الأصلي عن طلب يحتفظ صراحة بالمحتوى الأصلي. حدّد تركيب النتيجة المطلوب: الاستكمال وحده، أو مشهد يضم المقطع المقدّم والفعل الجديد.

لتوجيه واضح، افصل وصف المشهد الثابت عن تسلسل الأحداث. عرّف كل موضوع بسمتين أو ثلاث بصرية مميزة وتسمية متسقة. ثم صف الأفعال والمكان والإضاءة وحركة الكاميرا والأسلوب البصري والقيود. وفي الحوار، اربط كل عبارة بمتحدثها والفعل المعني. استخدم تسميات لقطات مرتبة بدل اعتبار الطوابع الزمنية الدقيقة إعدادات موثوقة: تلاحظ الشركة المصنّعة أن التوقيت الدقيق قد يكون غير مستقر. وقد تكون متطلبات منتج مرحلي: «تحدد Image 1 المنتج A. Shot 1: اقترب ببطء من المنتج A على المنضدة. Shot 2: تديره يد نحو الضوء. Shot 3: استقر على الملصق الأمامي. أجواء غرفة هادئة؛ حافظ على الحروف المطبوعة.»

أعدّ المراجع وفق قواعد إدخال العائلة الموثّقة. تشمل صيغ الصور المدعومة JPEG وPNG وWebP وBMP وTIFF وGIF وHEIC وHEIF؛ وتكون كل صورة أصغر من 30 MB. يحدد الدليل عرض الصورة وارتفاعها أكبر من 300 وأقل من 6,000 بكسل حصرًا، ونسبة عرض أكبر من 0.4 وأقل من 2.5 حصرًا. تستخدم مراجع الفيديو MP4 أوMOV مع فيديو H.264 أوH.265 وصوت AAC أوMP3، ولا تتجاوز 200 MB لكل منها، وبمعدل 24–60 إطارًا في الثانية. عرضها وارتفاعها 300–6,000 بكسل، ونسبة عرضها 0.4–2.5، وإجمالي بكسلاتها 407,696–8,295,044. تستخدم المراجع الصوتية WAV أوMP3 ولا تتجاوز 15 MB لكل منها. هذه مواصفات إعداد الإدخال لدى الشركة المصنّعة، منفصلة عن أدوات الرفع في تطبيق معين.

يتطلب سير عمل الصور الشخصية لدى الشركة المصنّعة إعدادًا محددًا للصور أو الفيديوهات التي تتضمن وجوه بشر حقيقيين: فالرفع المباشر للمراجع ليس المسار القياسي المدعوم. ويوثّق مخرجات نماذج موثوقة وشخصيات رقمية معدّة مسبقًا ومسارًا مصرحًا لمواد أشخاص حقيقيين بوصفها حلولًا منفصلة. وتحتاج مطابقة الصوت والنطق والصوت عند حدود المقطع إلى فحص أيضًا. يوصي دليل التوجيه بوصف خصائص الصوت المقصودة وإبقاء أسلوب الحوار قريبًا من المرجع الصوتي. راجع المادة النهائية للتحقق من اتساق الموضوع والكلمات المنطوقة الدقيقة وتوقيت الأفعال وانتقالات الإطارات وصوت النهاية؛ وحسّن العنصر المحدد الذي يختلف عن المتطلبات.

**Ailoot Ultra · فيديو** `POST /v1/videos` `bytedance/seedance-2.0-mini`

[`bytedance/seedance-2.0-mini`](https://ailoot.ai/models/ar/#m=bytedance%2Fseedance-2.0-mini&route=Ultra&caller=bytedance%2Fseedance-2.0-mini&fmt=videos)

ByteDance /`bytedance/seedance-2.0-mini`

### البداية

ينشئ Seedance 2.0 Mini فيديوهات قصيرة بصوت مولّد اختياريًا من النص والصور ومراجع الفيديو والصوت. يدعم إنشاء المشاهد وتعديلات الفيديو المحددة والاستكمال، مع مواصفات إخراج موثّقة بدقة 480p أو720p.

المدخلات المقبولة

النص · الصور · الصوت

النتائج

فيديو

### متاح في Ailoot · المدخلات والطرائق

**Ailoot Ultra · فيديو** `POST /v1/videos`

الإدخال

`text`, `image`, `audio`

الإخراج

`video`

صيغة الإخراج

بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز

| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
| --- | --- | --- | --- | --- |
| الحقل`model` | النوع`string` | المتطلبمطلوب | القيم والحدود bytedance/seedance-2.0-mini | القيمة الافتراضية— |
| الحقل`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-mini

`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-mini

`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-mini

`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.007** لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالمدخل: with\_video\_input | الرسوم reference · سعر توكن الفيديو · تقدير للمقارنة فقط **$0.0042** لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل 1K من رموز الفيديو | شروط الفوترةالصوت: without\_audio | الرسوم الإخراج · سعر توكن الفيديو · تقدير للمقارنة فقط **$0.007** لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط **$0.1512** تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/)

#### تفاصيل التعرفة المرجعية

لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.

مراجع أسعار إعدادات الفيديو

#### الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

| الإعدادات | شروط الفوترة | الرسوم |
| --- | --- | --- |
| الإعداداتسعر توكن الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر توكن الفيديو **$0.007** لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالصوت: without\_audio | الرسوم الإخراج · سعر توكن الفيديو **$0.007** لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |
| الإعداداتسعر توكن الفيديو | شروط الفوترةالمدخل: with\_video\_input | الرسوم reference · سعر توكن الفيديو **$0.0042** لكل 1K من رموز الفيديو تعرفة توكنات الفيديو هي المرجع الأساسي للسعر. أما التقديرات البارزة لكل ثانية فهي مراجع منفصلة، وليست رسومًا إضافية. |

### أمثلة للطلبات

#### Ailoot Ultra · فيديو

curl · أنشئ فيديو

```bash
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-mini","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`

##### التحقق من حالة المهمة

GET · جلب حالة العملية الأصلية

```bash
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
```

عمليات أخرى لقراءة المحتوى

حفظ كل المخرجات المكتملة المملوكة لك

```bash
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-mini`](https://ailoot.ai/models/ar/#m=bytedance%2Fseedance-2.0-mini&route=Ultra&caller=bytedance%2Fseedance-2.0-mini&fmt=videos)

#### الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

#### معرّفات النماذج ذات الصلة IDs

[`bytedance/seedance-2.0-mini`](https://ailoot.ai/models/ar/#m=bytedance%2Fseedance-2.0-mini&route=Ultra&caller=bytedance%2Fseedance-2.0-mini&fmt=videos)

FAQ · ByteDance: Seedance 2.0 Mini

ما المدخلات والنتائج المتاحة؟

`POST /v1/videos` · `bytedance/seedance-2.0-mini`: `text`, `image`, `audio` → `video`

ما الحقول التي يستخدمها الطلب؟

`POST /v1/videos` · `bytedance/seedance-2.0-mini`: `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-mini`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

## الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

## اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك

اختر خطة بخصم لطلباتك المنتظمة.

رمز خصم حتى 50%

أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.

المصروفات في السجل

يحفظ النموذج والرموز والمبلغ لكل طلب.

[اختر اشتراكا](https://ailoot.ai/docs/ar/billing/subscriptions/) · [اعرض أسعار النماذج](https://ailoot.ai/models/ar/)

## اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري

أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.

ترخيص إعادة البيع

أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.

المستندات على الموقع

العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

[اطلب ترخيص إعادة بيع](mailto:support@ailoot.ai) · [العرض واتفاقية الترخيص](https://ailoot.ai/legal/offer?lang=ar)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.