MiniMax-Hailuo-2.3

ينشئ MiniMax Hailuo 2.3 فيديو من نص أو صورة افتتاحية، مع عناصر تحكّم في الحركة واتجاه الكاميرا. اختر ست ثوانٍ بدقة 768P أو 1080P، أو عشر ثوانٍ بدقة 768P، لأداء الشخصيات والمشاهد ذات الأسلوب الفني ولقطات المنتجات التي يمكن مراجعتها وتحريرها.

Ailoot · فيديو POST /v1/videos/generations MiniMax-Hailuo-2.3
Ailoot Ultra · فيديو POST /v1/videos MiniMax-Hailuo-2.3

عن النموذج

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

MiniMax Hailuo 2.3 نموذج لتوليد الفيديو بوضعَي تحويل النص إلى فيديو وتحويل الصورة إلى فيديو. ويستند إلى Hailuo 02 مع تركيز على الفعل الفيزيائي والأسلوب البصري وتعابير الشخصية الدقيقة والاستجابة لتعليمات الحركة. قدّم مشهدًا مكتوبًا لإنشاء لقطة من الصفر، أو استخدم صورة افتتاحية لتحديد المنظر الأول وصِف الحركة التي تليه.

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

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

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

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

في تحويل النص إلى فيديو، يمكن للوصف المطلوب أن يحتوي على ما يصل إلى 2,000 حرف. اذكر العنصر الرئيسي والفعل والمكان والأسلوب البصري بترتيب مترابط. ويتطلّب تحويل الصورة إلى فيديو صورة للإطار الافتتاحي، مع وصف اختياري حتى 2,000 حرف. تثبّت الصورة التكوين الافتتاحي، لذا جهّز العنصر والتأطير قبل طلب الحركة. واترك مساحة ظاهرة حيث تحتاج ذراع أو جسم أو شخصية إلى التحرّك.

تقبل الصورة الافتتاحية صيغ JPG أو JPEG أو PNG أو WebP، ويجب أن يكون حجمها أقل من 20 MB، وأن يزيد ضلعها القصير على 300 بكسل، وأن تكون نسبة أبعادها بين 2:5 و5:2. ويمكن تقديمها بعنوان URL عام للصورة أو بعنوان بيانات Base64. اختر صورة افتتاحية واضحة بدلًا من الاعتماد على التحريك لإصلاح وجه محجوب أو فعل مقتطع مسبقًا.

يولّد Hailuo 2.3 بمعدل 24 إطارًا في الثانية. ويمكن للقطة من ست ثوانٍ استخدام 768P أو 1080P؛ بينما تستخدم لقطة العشر ثوانٍ 768P. والقيمتان الافتراضيتان هما ست ثوانٍ و768P. اختر المدة وفق الفعل المطلوب: قد يلائم رد فعل سريع لقطة قصيرة، بينما تحتاج حركة أبطأ إلى وقت أوسع. اقرأ العرض والارتفاع الفعليين للنتيجة المكتملة عند وضع المقطع في المونتاج، إذ لا تحدّد تسمية الدقة وحدها كامل قرار التأطير.

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

يُفعَّل التحسين التلقائي للتوجيه افتراضيًا، ويمكن تعطيله للتحكّم الأدق في الصياغة المقدَّمة. وتقلّل المعالجة المسبقة السريعة الاختيارية زمن التحسين عند تفعيله؛ وهي إعداد مستقل عن اختيار نموذج Hailuo 2.3 Fast. يدعم Hailuo 2.3 القياسي وضعَي الإنشاء، بينما يشكّل Fast الإصدار المستقل لتحويل الصورة إلى فيديو. اختر الإصدار وفق ما إذا كان المشروع يبدأ بنص وحده أم بإطار موجود.

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

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

Ailoot · فيديو POST /v1/videos/generations MiniMax-Hailuo-2.3

MiniMax-Hailuo-2.3

MiniMax /MiniMax-Hailuo-2.3

البداية

المدخلات المقبولة: النص · الصور
النتائج: فيديو

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

Ailoot · فيديو POST /v1/videos/generations

الإدخال: text, image
الإخراج: video
صيغة الإخراج: mp4

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود MiniMax-Hailuo-2.3	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩ الحد الأقصى للطول: ⁦2,000⁩ الوحدة: محارف Unicode	القيمة الافتراضية—
الحقل`duration`	النوع`integer`	المتطلباختياري	القيم والحدود ⁦6⁩, ⁦10⁩ الشروط: مدة 10 ثوانٍ تتطلب 768P الوحدة: ثوانٍ	القيمة الافتراضية⁦6⁩
الحقل`resolution`	النوع`string`	المتطلباختياري	القيم والحدود 768P, 1080P الشروط: تتطلب 1080P مدة 6 ثوانٍ	القيمة الافتراضية768P
الحقل`first_frame_image`	النوع`https_url\|data_image_url`	المتطلباختياري	القيم والحدود الحد الأقصى للبايتات بعد فك الترميز: ⁦20,971,520⁩ أنواع MIME: image/jpeg, image/png, image/webp الحد الأدنى للأبعاد (غير شامل): ⁦300⁩ نطاق نسبة الأبعاد: 2:5, 5:2	القيمة الافتراضية—
الحقل`prompt_optimizer`	النوع`boolean`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—
الحقل`fast_pretreatment`	النوع`boolean`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—

تركيبات مواد الإدخال

تحويل الصورة إلى فيديو · مطلوب: prompt, first_frame_image

تحويل النص إلى فيديو · مطلوب: prompt

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`material_types`	المواصفاتtext, image
المعلمة`required`	المواصفاتnull
المعلمة`optional_controls`	المواصفاتnull

دورة الحياة: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.

الباقات

تعرفات طرائق Ailoot

Ailoot فيديوPOST /v1/videos/generations

الإخراج: ⁦‏0.28 US$⁩ لكل فيديو مدته 6 ثوانٍ بدقة 768p

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

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

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

MiniMax-Hailuo-2.3

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

الإعدادات	شروط الفوترة	الرسوم
الإعداداتMiniMax-Hailuo-2.3 · الإعداد الافتراضي	شروط الفوترةالإعداد الافتراضي	الرسوم الإدخال · الإدخال ⁦‏0.00 US$⁩ لكل استدعاء الإخراج · الإخراج ⁦‏0.60 US$⁩ لكل استدعاء

MiniMax-Hailuo-2.3

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

الإعدادات	شروط الفوترة	الرسوم
الإعداداتMiniMax-Hailuo-2.3 · الإعداد الافتراضي	شروط الفوترةالإعداد الافتراضي	الرسوم الإدخال · الإدخال ⁦‏0.00 US$⁩ لكل استدعاء الإخراج · الإخراج ⁦‏1.20 US$⁩ لكل استدعاء

MiniMax-Hailuo-2.3

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

الإعدادات	شروط الفوترة	الرسوم
الإعداداتMiniMax-Hailuo-2.3 · الإعداد الافتراضي	شروط الفوترةالإعداد الافتراضي	الرسوم الإدخال · الإدخال ⁦‏0.00 US$⁩ لكل استدعاء الإخراج · الإخراج ⁦‏1.20 US$⁩ لكل استدعاء

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

Ailoot · فيديو

مثال للفيديو

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'

استلام النتائج وحفظها

Ailoot · فيديو

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

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

GET · جلب الحالة

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

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

GET · جلب المحتوى

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

الاحتفاظ بكل النتائج المكتملة

احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.

احتفظ بكل عنصر بيانات أو فهرس مخرج مُعاد. يشير content_url إلى الأول فقط؛ اجلب كل مسار محتوى أو أصل فعلي. لا يعيد طلب GET للمحتوى دون index جميع المخرجات.

عند الحاجة إلى التحقق من الاستجابة الأصلية

اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.

حقول الاستجابة

الحقل	النوع
الحقل`id`	النوعstring
الحقل`object`	النوعstring
الحقل`model`	النوعstring
الحقل`status`	النوعstring
الحقل`content_url`	النوعsigned URL
الحقل`data[]`	النوعsigned URL
الحقل`usage`	النوعobject
الحقل`result_pending_check`	النوعboolean

الأخطاء والخطوات التالية

الاستجابة	الشرط	الخطوة التالية
الاستجابة⁦400⁩ · `invalid_request_error`	الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة	الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد.
الاستجابة⁦409⁩ · `video_not_ready`	الشرطمحتوى النتيجة الأصلية غير متاح بعد	الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After.
الاستجابة`server_error`	الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق	الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3

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

/v1/videos/generations, /videos, /videos/generations

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

MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3

Ailoot Ultra · فيديو POST /v1/videos MiniMax-Hailuo-2.3

MiniMax-Hailuo-2.3

MiniMax /MiniMax-Hailuo-2.3

البداية

المدخلات المقبولة: النص
النتائج: فيديو

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

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

الإدخال: text
الإخراج: video
صيغة الإخراج: mp4
عدد المخرجات: حتى ⁦1⁩ إخراج

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود MiniMax-Hailuo-2.3	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩ الحد الأقصى للطول: ⁦2,000⁩ الشروط: عند 768P: بحد أقصى 2000 نقطة ترميز Unicode. عند 1080P: أقل من 200 نقطة ترميز Unicode (بحد أقصى 199). يجب أن يحتوي الموجّه النصي على نص يتجاوز المحارف البيضاء. الوحدة: محارف Unicode	القيمة الافتراضية—
الحقل`duration`	النوع`integer`	المتطلبمطلوب	القيم والحدود ⁦6⁩ الوحدة: ثوانٍ	القيمة الافتراضية—
الحقل`resolution`	النوع`string`	المتطلبمطلوب	القيم والحدود 768P, 1080P	القيمة الافتراضية—

تركيبات مواد الإدخال

تحويل النص إلى فيديو · مطلوب: prompt

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, prompt, duration, resolution
المعلمة`other_options`	المواصفاتfalse
المعلمة`duration`	المواصفات6
المعلمة`resolution`	المواصفات768P, 1080P
المعلمة`prompt_max_characters`	المواصفات2000
المعلمة`material_types`	المواصفاتtext
المعلمة`prompt_max_characters_by_resolution`	المواصفات{"768P":2000,"1080P":199}

الأسماء البديلة للطريقة: /v1/videos/generations, /videos, /videos/generations

دورة الحياة: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

أنشئ مرة واحدة واحفظ المعرّف المُعاد.

استعلم دورياً عن الحالة الأصلية؛ واحتفظ بكل أصل مكتمل ومدته.

الباقات

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع: غير محدد عند اختيار الوضع السريع
الوضع المرن: غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات Ailoot

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

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

الإعدادات	جدول التعرفة	المدة الاسمية للمقطع بالثواني	الدقة	وحدة الفوترة	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	المدة الاسمية للمقطع بالثواني—	الدقة—	وحدة الفوترة—	الرسوم الإدخال · رموز الإدخال — / 1K من الرموز الإخراج · رموز الإخراج — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز
الإعداداتUltra	جدول التعرفة—	المدة الاسمية للمقطع بالثواني⁦6⁩	الدقة1080P	وحدة الفوترةلكل مقطع إخراج بمدة اسمية 6s	الرسوم الإخراج · مقطع ناتج بمدة اسمية 6s $1.2 لكل مقطع إخراج بمدة اسمية 6s
الإعداداتUltra	جدول التعرفة—	المدة الاسمية للمقطع بالثواني⁦6⁩	الدقة768P	وحدة الفوترةلكل مقطع إخراج بمدة اسمية 6s	الرسوم الإخراج · مقطع ناتج بمدة اسمية 6s $0.6 لكل مقطع إخراج بمدة اسمية 6s

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

MiniMax-Hailuo-2.3

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

الإعدادات	شروط الفوترة	الرسوم
الإعداداتMiniMax-Hailuo-2.3 · الإعداد الافتراضي	شروط الفوترةالإعداد الافتراضي	الرسوم الإدخال · الإدخال ⁦‏0.00 US$⁩ لكل استدعاء الإخراج · الإخراج ⁦‏0.60 US$⁩ لكل استدعاء

MiniMax-Hailuo-2.3

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

الإعدادات	شروط الفوترة	الرسوم
الإعداداتMiniMax-Hailuo-2.3 · الإعداد الافتراضي	شروط الفوترةالإعداد الافتراضي	الرسوم الإدخال · الإدخال ⁦‏0.00 US$⁩ لكل استدعاء الإخراج · الإخراج ⁦‏1.20 US$⁩ لكل استدعاء

MiniMax-Hailuo-2.3

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

الإعدادات	شروط الفوترة	الرسوم
الإعداداتMiniMax-Hailuo-2.3 · الإعداد الافتراضي	شروط الفوترةالإعداد الافتراضي	الرسوم الإدخال · الإدخال ⁦‏0.00 US$⁩ لكل استدعاء الإخراج · الإخراج ⁦‏1.20 US$⁩ لكل استدعاء

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

Ailoot Ultra · فيديو

curlcurl · 1080P / 6 ثوانٍ

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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

استلام النتائج وحفظها

Ailoot Ultra · فيديو

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

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

GET · جلب الحالة

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
    for x in r.get("data",[]):print(x)
PY_STATUS

حفظ جميع الأصول المكتملة

GET · جلب جميع الأصول المكتملة

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
    if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
    u=urljoin("https://api.ailoot.ai",x)
    z=urlsplit(u)
    if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
    urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" \
    -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
  index=$((index + 1))
done < asset-urls.txt

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

GET · جلب المحتوى

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4

الاحتفاظ بكل النتائج المكتملة

احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.

تحتوي data[] المكتملة على جميع عناوين URL الموقّعة للمحتوى المملوك لك. اجلب كل عنوان URL مُعاد، أو استخدم نقطة نهاية المحتوى مع ضبط index على فهرس مخرج فعلي. قد تُعيد المهمة الأصلية الفاشلة charge_pending_check؛ تحقق من تلك المهمة الأصلية بدلاً من إنشائها مرة أخرى.

عند الحاجة إلى التحقق من الاستجابة الأصلية

اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.

الحد الأقصى للمخرجات: ⁦1⁩.

حقول الاستجابة

الحقل	النوع
الحقل`id`	النوعstring
الحقل`object`	النوعstring
الحقل`model`	النوعstring
الحقل`status`	النوعstring
الحقل`data[]`	النوعsigned content URL
الحقل`charge_pending_check`	النوعboolean
الحقل`error.code`	النوعstring
الحقل`error.message`	النوعstring
الحقل`requested_nominal_duration_seconds`	النوعinteger
الحقل`measured_duration_seconds`	النوعnumber
الحقل`width`	النوعinteger
الحقل`height`	النوعinteger

الأخطاء والخطوات التالية

الاستجابة	الشرط	الخطوة التالية
الاستجابة⁦400⁩ · `invalid_request_error`	الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة	الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد.
الاستجابة⁦409⁩ · `video_not_ready`	الشرطمحتوى النتيجة الأصلية غير متاح بعد	الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After.
الاستجابة`server_error`	الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق	الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3

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

/v1/videos/generations, /videos, /videos/generations

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

MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3

FAQ · MiniMax-Hailuo-2.3

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

POST /v1/videos/generations · MiniMax-Hailuo-2.3: text, image → video

POST /v1/videos · MiniMax-Hailuo-2.3: text → video

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

POST /v1/videos/generations · MiniMax-Hailuo-2.3: model, prompt, duration, resolution, first_frame_image, prompt_optimizer, fast_pretreatment

POST /v1/videos · MiniMax-Hailuo-2.3: model, prompt, duration, resolution

ما الحدود المطبقة؟

POST /v1/videos/generations · MiniMax-Hailuo-2.3: prompt.maximum_length: 2000

POST /v1/videos · MiniMax-Hailuo-2.3: prompt.maximum_length: 2000

MiniMax-Hailuo-2.3