Source: https://ailoot.ai/models/ar/minimax-hailuo-3/ Canonical: https://ailoot.ai/models/ar/minimax-hailuo-3/ Language: ar # MiniMax: H3 [Markdown](https://ailoot.ai/models/ar/minimax-hailuo-3/index.md) · [JSON](https://ailoot.ai/models/ar/minimax-hailuo-3/facts.json) ## [MiniMax: H3](https://ailoot.ai/models/ar/minimax-hailuo-3/) يولّد MiniMax H3 فيديو قصيرًا بصوت ستيريو أصلي من نص أو صور إطارات أو مراجع متعددة الوسائط. ويدعم الإنشاء من الإطار الأول والأخير، والتحرير الموجّه بالمراجع، وعلاقات الحركة أو الصوت، بمخرجات مدتها 4–15 ثانية ومسار مستقل لإعادة التوليد بدقة 2K. - [**Ailoot Ultra · فيديو** `POST /v1/videos` `minimax/hailuo-3`](https://ailoot.ai/models/ar/minimax-hailuo-3/#method-0) عن النموذج يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة. نتيجة سمعية بصرية واحدة من توجيه متعدد الوسائط MiniMax H3 نظام الفيديو الشامل للوسائط لدى MiniMax. يفسّر النص والصور والفيديو والصوت معًا، ثم يولّد فيديو بصوت ستيريو أصلي. وتقدّمه الجهة المطوّرة لأعمال إبداعية قصيرة مثل صور المنتجات والإعلانات والملصقات المتحركة ومفاهيم عناوين الأفلام، حيث تهم العلاقات بين المواد المرجعية بقدر أهمية وصف المشهد. ينتج النظام الموثّق فيديو مدته 4–15 ثانية بمعدل 24 إطارًا في الثانية وصوت ستيريو بتردد 32 kHz. يعمل توليد H3-Base بدقة 768p؛ ويعيد مسار 2K الكامل توليد هذه النتيجة باستخدام السياق الأصلي متعدد الوسائط. ويتجاوز ذلك تغيير الحجم التقليدي: فالمرحلة الثانية تستخدم النموذج والسياق المصدري مجددًا لاستعادة التفاصيل الدقيقة. ولH3 Max وH3-Context-IR أدوار وحدود مستقلة. الإنشاء من النص وبالتوجيه بالإطارات تصف المدخلات النصية وحدها الخط الزمني السمعي البصري كاملًا. تثبّت صورة أولى الافتتاح، وتثبّت صورة أخيرة النهاية، ويمكن لصورتين تحديدهما معًا. وللقطة تعتمد على الإطار الأول، ابدأ بالتكوين والهوية الظاهرين في الصورة الثابتة، ثم صِف الفعل الذي يتطور منها. وللانتقال من إطار أول إلى أخير، صِف الحركة المرئية التي تصل بين الحالتين بدلًا من تكرار وصفين لصورتين غير مترابطتين. يمكن لتوجيه عملي خاص بمنتج أن يحدّد عبوة مغلقة في الإطار الافتتاحي، واليد التي تفتحها، وحركة الكاميرا الهادئة، والحالة النهائية المطلوبة. حافظ على شكل الجسم وموضع الملصق والإضاءة في الإطارات المقدَّمة. والإنشاء الموجّه بالإطارات والإنشاء الموجّه بالمراجع وضعا إدخال منفصلان؛ فلا تمزج واجهة الجهة المطوّرة أدوار الإطار الأول والأخير بأدوار الوسائط المرجعية في طلب واحد. التوليد والتحرير الموجّهان بالمراجع يقبل وضع المراجع نصًا مع صور ومقاطع فيديو ومقاطع صوتية. حدّد ما يضيفه كل مصدر: مظهر شخصية أو موقع أو حركة كاميرا أو البنية الزمنية لمقطع أصلي أو صوت. ويختلف الفيديو المستخدم لحركة الكاميرا فقط عن فيديو تريد تحريره أو استكماله بالفعل. اذكر هذه العلاقة صراحة. يفصل دليل المراجع لدى الجهة المطوّرة بين تعريفات العناصر وملخّص المهمة وتحليل ما يُحتفظ به ووصف اللقطة التفصيلي والمشهد الصوتي العام والموسيقى الخلفية المسموعة للجمهور وحده. ويميّز بين الحفاظ على المحتوى المرئي ونقل الصفات أو استخدام مرجع عام للأسلوب. وفي الصوت، يختلف نسخ الإشارة عن الاسترشاد بجرسها أو إيقاعها أو أدائها. أبقِ هذه الأدوار ثابتة في كامل التوجيه. لمشهد موجّه بالمراجع، قدّم صورة للشخصية ومرجعًا قصيرًا لحركة الكاميرا ومرجعًا صوتيًا للصوت، ثم صِف موضع تأثير كل منها في اللقطة المستهدفة. حدّد تفاصيل الملابس أو البيئة أو الأجسام التي يجب أن تبقى قابلة للتعرّف. وقارن المقطع المكتمل بهذه المتطلبات، بما فيها استمرارية الحركة والعلاقة بين المتحدّث الظاهر والصوت المسموع. الكلام والصوت وتوقيت اللقطات ينمذج H3 الحوار والأصوات المادية والأجواء والموسيقى معًا. وتوثّق بطاقة النموذج دعمًا مستقرًا للحوار بالعربية والصينية والإنجليزية والفرنسية والألمانية والإيطالية واليابانية والكورية والبرتغالية والروسية والإسبانية؛ فيما تصف دعم اللغات الأخرى بأنه متفاوت. قدّم الكلمات المنطوقة الدقيقة ولغتها، مع هوية ثابتة للمتحدّث بين اللقطات. تستخدم أدلة كتابة التوجيه لدى الجهة المطوّرة الإنجليزية للأجزاء الوصفية، مع إبقاء الحوار والنص الظاهر بلغتهما الأصلية. ويستخدم المحتوى المنطوق الصيغة `[Language] ...`، مع هوية المتحدّث ووصف صوته خارج الكتلة. ميّز الكلام الصادر داخل المشهد عن التعليق الصوتي خارج الشاشة، وحدّد إن كانت العبارة تستمر عبر قطع أو تتوقّف بسبب نهاية المقطع. وحافظ أيضًا على النص الظاهر كما هو بالضبط. اجعل كمية الكلام مناسبة للمدة المختارة وافحص الكلمات المعروضة والعبارة المسموعة معًا. صِف حركة الكاميرا بوصفها فعلًا، مع نطاقها وسرعتها عندما يكونان مهمين. رقّم اللقطات حسب ترتيب عرضها واجعل أزمنة القطع ضمن مدة الفيديو. وافصل أصوات المشهد كوقع الخطوات أو إغلاق باب عن الموسيقى الخلفية التي يسمعها الجمهور وحده. تجعل هذه الخيارات خطة اللقطة القصيرة أسهل فهمًا وأسهل مراجعةً مقابل النتيجة. تجهيز المدخلات والحدود العددية يتطلّب مخطط التوليد الحالي نصًا غير فارغ في كل وضع، بحد أقصى 7,000 حرف لكل عنصر نصي. ويمكن للصور أن تكون JPG أو JPEG أو PNG أو WebP أو HEIC أو HEIF، حتى 30 MB للصورة، مع كل ضلع من 256 إلى 5,760 بكسل ونسبة أبعاد من 0.4 إلى 2.5. تسمح مدخلات الإطارات بصورة افتتاحية وأخرى ختامية؛ ويسمح وضع المراجع بما يصل إلى تسع صور مرجعية. يمكن أن يحتوي الفيديو المرجعي على ما يصل إلى ثلاثة مقاطع MP4 أو MOV، مدة كل منها 2–15 ثانية وبإجمالي لا يتجاوز 15 ثانية. ويمكن أن يبلغ المقطع 50 MB؛ ويكون ترميز الفيديو H.264 أو H.265، مع صوت AAC أو MP3، وأضلاع من 256 إلى 5,760 بكسل، ونسب من 0.4 إلى 2.5، ومعدل إطارات من 23.976 إلى 60. ويدعم الصوت المرجعي ما يصل إلى ثلاثة مقاطع WAV أو MP3، حتى 15 MB للمقطع، ومدة 2–15 ثانية لكل منها وبإجمالي لا يتجاوز 15 ثانية. وتحدّد بطاقة النموذج سقف المدخلات المرجعية المختلطة عند 12 ملفًا. والحد الموثّق لجسم الطلب هو 64 MB، وهو مستقل عن حدود كل ملف. اختر المراجع التي تسهم في التوجيه فقط، واجعل إسهام كل منها صريحًا. فرؤية واضحة للعنصر الرئيسي أنفع من عدة زوايا متعارضة بلا شرح. حافظ على ترتيب المراجع، واقتصّ المواد غير ذات الصلة من دون إزالة سياق ضروري للمشهد، وتحقّق من احتواء المقاطع المصدرية القصيرة على الفعل أو السمة الصوتية المطلوبة. شكل المخرجات والنظام الكامل توفّر واجهة H3 لدى الجهة المصنّعة دقتي 768P و2K. ويتطلّب التوليد من النص وحده نسبة محدّدة: 21:9 أو 16:9 أو 4:3 أو 1:1 أو 3:4 أو 9:16. ويستمد الإنشاء من الإطار الأول والأخير نسبة أبعاده من الصورة المدخلة؛ ويمكن للإنشاء المرجعي استخدام نسبة متكيفة أو صريحة. ومدة المخرجات عدد صحيح من 4 إلى 15 ثانية. تميّز بطاقة النموذج بين H3-Context-IR الذي يفسّر التوجيه ويثريه، وH3-Base الذي يولّد المحتوى السمعي البصري، وH3-Regenerate-2K الذي ينشئ النتيجة الأعلى دقة. وتفصل نقاط التحقّق الأساسية المنشورة بين مهام التوجيه بالإطارات ومهام المراجع الشاملة. ومكوّنا السياق وإعادة التوليد منفصلان عن أوزان الأساس هذه، لذا لا يكفي اسم نقطة تحقّق مفتوحة وحده لإثبات سلوك النظام كاملًا. مسار التوليد لدى الجهة المطوّرة غير متزامن. وتسترجع واجهة الاستعلام المهام من الأيام السبعة السابقة. احتفظ بهوية المهمة حتى عودة نتيجة الفيديو الفعلية، ثم احفظ المقطع بدلًا من الاكتفاء بعنوان تنزيل محدود الصلاحية. راجع الهوية البصرية والنص الصغير وتفاعلات الأجسام والمحتوى المنطوق وتوقيت الصوت بحجم العرض المقصود. وتعدّ الجهة المصنّعة فهم الوسائط المتعددة والتفاصيل البصرية الدقيقة مجالي تحسين مستمرين؛ ويظل التوجيه المفصّل والمقارنة بالمصادر عنصرين أساسيين للحصول على نتيجة مفيدة. **Ailoot Ultra · فيديو** `POST /v1/videos` `minimax/hailuo-3` [`minimax/hailuo-3`](https://ailoot.ai/models/ar/#m=minimax%2Fhailuo-3&route=Ultra&caller=minimax%2Fhailuo-3&fmt=videos) MiniMax /`minimax/hailuo-3` ### البداية يولّد MiniMax H3 فيديو قصيرًا بصوت ستيريو أصلي من نص أو صور إطارات أو مراجع متعددة الوسائط. ويدعم الإنشاء من الإطار الأول والأخير، والتحرير الموجّه بالمراجع، وعلاقات الحركة أو الصوت، بمخرجات مدتها 4–15 ثانية ومسار مستقل لإعادة التوليد بدقة 2K. المدخلات المقبولة النص · الصور · الصوت · فيديو النتائج فيديو ### متاح في Ailoot · المدخلات والطرائق **Ailoot Ultra · فيديو** `POST /v1/videos` الإدخال `text`, `image`, `audio`, `video` الإخراج `video` صيغة الإخراج بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز | الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية | | --- | --- | --- | --- | --- | | الحقل`model` | النوع`string` | المتطلبمطلوب | القيم والحدود minimax/hailuo-3 | القيمة الافتراضية— | | الحقل`prompt` | النوع`string` | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— | | الحقل`duration` | النوع`integer` | المتطلبمطلوب | القيم والحدود ⁦5⁩, ⁦6⁩, ⁦7⁩, ⁦8⁩, ⁦9⁩, ⁦10⁩, ⁦11⁩, ⁦12⁩, ⁦13⁩, ⁦14⁩, ⁦15⁩ الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦600⁩ | القيمة الافتراضية— | | الحقل`resolution` | النوع`string` | المتطلباختياري | القيم والحدود 2K | القيمة الافتراضية— | | الحقل`aspect_ratio` | النوع`string` | المتطلباختياري | القيم والحدود 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | القيمة الافتراضية— | | الحقل`generate_audio` | النوع`boolean` | المتطلباختياري | القيم والحدود false, true | القيمة الافتراضية— | | الحقل`frame_images` | النوع`array` | المتطلباختياري | القيم والحدود الحد الأدنى للعناصر: ⁦1⁩ الحد الأقصى للعناصر: ⁦2⁩ محتوى الإدخال: مصفوفة من كائنات الإطارات. يحتوي كل كائن على type=image\_url وimage\_url الذي يحتوي على url، وعلى frame\_type. استخدم عنوان URL لصورة عبر HTTPS واضبط frame\_type على first\_frame أو last\_frame. لا يتكرر كل دور إطار أكثر من مرة. المفاتيح الدقيقة: type, image\_url, frame\_type الشروط: تصف هذه المفاتيح كل كائن إطار؛ ولا يحتوي image\_url إلا على url. احذف frame\_images في الطلبات النصية فقط. | القيمة الافتراضية— | | الحقل`input_references` | النوع`array` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— | | الحقل`callback_url` | النوع`string` | المتطلباختياري | القيم والحدود النمط: ^https:// | القيمة الافتراضية— | | الحقل`session_id` | النوع`string` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— | | الحقل`trace` | النوع`object` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— | | الحقل`user` | النوع`string` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— | تركيبات مواد الإدخال **تحويل النص إلى فيديو** · موجّه نصي. · مطلوب: model, prompt, duration `قدّم prompt كنص وduration بعدد صحيح من الثواني. اختر دقة مدعومة ونسبة أبعاد عند الحاجة.` `model`: النوع: string · minimax/hailuo-3 `prompt`: النوع: string · الحد الأقصى لبايتات UTF-8: ⁦10,000⁩ · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم **تحويل الصورة إلى فيديو** · موجّه نصي وصورة للإطار الأول. · مطلوب: model, prompt, duration, frame\_images `الحقل frame_images مصفوفة. يحتوي كل كائن إطار على type وimage_url وframe_type؛ ويحتوي image_url على url. اضبط type على image_url. استخدم first_frame مع last_frame اختياري. لا يتكرر كل دور إطار أكثر من مرة. وفّر عنوان URL عاماً لصورة عبر HTTPS لكل إطار. استخدم صور الإطارات أو مراجع الصور في الطلب الواحد؛ ولا تجمع بينهما. اختر دقة مدعومة ونسبة أبعاد عند الحاجة.` المفاتيح الدقيقة: type, image\_url, frame\_type `model`: النوع: string · minimax/hailuo-3 `prompt`: النوع: string · الحد الأقصى لبايتات UTF-8: ⁦10,000⁩ · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم **Reference to video** · موجّه نصي ومراجع صور وفيديو وصوت مدعومة. · مطلوب: model, prompt, duration, input\_references `الحقل input_references مصفوفة كائنات. اضبط type على image_url أو video_url أو audio_url، واستخدم الحقل المطابق الذي يحتوي على url. استخدم عناوين URL عامة عبر HTTPS. احذف frame_images لاختيار نمط المراجع. يتضمن التقدير مكوّن التكلفة المعروض لكل صورة للمراجع الصورية بعد الصور الخمس الأولى فقط. يتبع الرسم النهائي الإعداد الذي حُوسب فعلياً. لا تجمع مراجع الصور مع صور الإطارات. اختر دقة مدعومة ونسبة أبعاد عند الحاجة.` `model`: النوع: string · minimax/hailuo-3 `prompt`: النوع: string · الحد الأقصى لبايتات UTF-8: ⁦10,000⁩ · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم معلمات الطريقة ودورة حياتها | المعلمة | المواصفات | | --- | --- | | المعلمة`content_type` | المواصفاتapplication/json | | المعلمة`required` | المواصفاتmodel, prompt, duration | | المعلمة`material_types` | المواصفاتtext, image, audio, video | | المعلمة`additional_properties` | المواصفاتfalse | | المعلمة`optional_controls` | المواصفاتresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, 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 من الرموز | | الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط **$0.26** لكل ثانية فيديو | | الإعداداتصورة مرجعية | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل صورة مرجعية | شروط الفوترة— | الرسوم الإدخال · صورة مرجعية · تقدير للمقارنة فقط **$0.08** لكل صورة مرجعية | | الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط **$1.3** تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. | تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/) #### تفاصيل التعرفة المرجعية لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة. مراجع أسعار إعدادات الفيديو #### الأسعار حسب الإعدادات طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة. | الإعدادات | شروط الفوترة | الرسوم | | --- | --- | --- | | الإعداداتسعر الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر الفيديو **$0.26** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. | | الإعداداتالصور المرجعية بعد الصور الخمس الأولى | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإدخال · الصور المرجعية بعد الصور الخمس الأولى **$0.08** لكل صورة الصور المرجعية الخمس الأولى مجانية؛ ويُطبَّق السعر المدرج لكل صورة بعد الصور الخمس الأولى. هذا مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الذي حُوسب فعلياً. | ### أمثلة للطلبات #### 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('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', 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** [`minimax/hailuo-3`](https://ailoot.ai/models/ar/#m=minimax%2Fhailuo-3&route=Ultra&caller=minimax%2Fhailuo-3&fmt=videos) #### الأسماء البديلة لمسارات الطرائق استخدم مسارات الطرائق المعروضة أعلاه. #### معرّفات النماذج ذات الصلة IDs [`minimax/hailuo-3`](https://ailoot.ai/models/ar/#m=minimax%2Fhailuo-3&route=Ultra&caller=minimax%2Fhailuo-3&fmt=videos) FAQ · MiniMax: H3 ما المدخلات والنتائج المتاحة؟ `POST /v1/videos` · `minimax/hailuo-3`: `text`, `image`, `audio`, `video` → `video` ما الحقول التي يستخدمها الطلب؟ `POST /v1/videos` · `minimax/hailuo-3`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `callback_url`, `session_id`, `trace`, `user` ما الحدود المطبقة؟ `POST /v1/videos` · `minimax/hailuo-3`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1` اربط 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 إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.