نبذة على المشروع
MiniMax H3 Cloud for Codex هي إضافة لتوليد الفيديو مدعومة بـ GPU سحابية. كتخلي المستخدم يطلب الخدمة مباشرة من Codex، والإضافة كتهتم باختيار القدرة الحاسوبية، وإنشاء النسخة أو تشغيلها، وتجهيز ComfyUI Runtime، وإرسال سير العمل، وتنزيل MP4، ومن بعد كتوقف النسخة ملي كتسالي المهمة.
الإضافة دابا كتدعم منصة يويوان للحساب، وREADME كيشير بلي غادي يتزاد دعم منصات أخرى من بعد. الإضافة راسها مجانية، ولكن موارد السحابة المستعملة بحال GPU، وقرص النظام، والصورة، كتتحاسب مباشرة من طرف يويوان للحساب.
تنبيه بخصوص الرخصة: المستودع ما فيهش أوزان نموذج MiniMax H3. النموذج خاضع لـ MiniMax H3 Community License Agreement، والاتفاقية دابا كتستثني بشكل واضح مناطق بحال الاتحاد الأوروبي، والمملكة المتحدة، وكوريا الجنوبية، والولايات المتحدة. المستخدمون اللي كاينين فالمناطق المستثناة خاصهم ياخدو ترخيص مستقل من MiniMax قبل الاستعمال، ويتأكدو بلي المنطقة، والاستعمال، وخدمات المنصة متوافقين مع الشروط المعنية.
الوظائف الرئيسية
ثلاث طرق لتوليد الفيديو
- فيديو من النص: توليد فيديو اعتماداً على وصف نصي.
- فيديو من الإطارات الرئيسية: تقدر تعطي الإطار الأول، أو الأخير، أو بجوج.
- فيديو من الصور المرجعية: كيدعم من 1 حتى لـ 9 صور مرجعية.
سير عمل سحابي مؤتمت
الإضافة كتعاون فمعاينة أثمنة GPU والمخزون، ومن بعد ما كيأكد المستخدم الإعدادات كتدير باقي المراحل، بحال تشغيل نسخة القدرة الحاسوبية، وتجهيز ComfyUI Runtime، وإرسال سير عمل الفيديو، وتنزيل النتيجة، وإغلاق النسخة.
الحماية ديال المصاريف والإيقاف
قبل إنشاء موارد مؤدى عليها، خاص الإضافة تاخد تأكيد المستخدم. فالإعداد الافتراضي، الإضافة كتضبط إيقاف احتياطي من بعد 30 دقيقة، وكتوقف النسخة مباشرة من بعد ما كتسالي المهمة أو كتفشل، باش تنقص من خطر المصاريف الإضافية الناتجة عن بقاء النسخة خدامة.
تدبير بيانات الدخول محلياً
الإضافة ما كتطلبش من المستخدم يرسل API Key فمحادثة Codex. بيانات الدخول ديال يويوان للحساب كيتخباو محلياً فالجهاز باستعمال CompShare CLI، والإعدادات والفيديوهات المولدة كاينين حتى هما خارج مجلد تثبيت الإضافة، وبهذا ترقية الإضافة ما كتغطيش على بيانات المستخدم.
التحضير قبل التثبيت
قبل ما تبدا التثبيت، تأكد بلي البيئة المحلية كتستوفي الشروط التالية:
- نظام التشغيل هو macOS أو Linux.
- مثبّت Codex كيدعم وظائف الإضافات.
- إصدار Node.js هو 20 أو أكثر.
- متوفرين فالنظام
sshوffprobe. - عندك حساب وAPI Key ديال يويوان للحساب.
- إصدار CompShare CLI هو 0.3.5 أو أكثر.
تثبيت CompShare CLI
تقدر تثبّت أو ترقي CompShare CLI من خلال PyPI، ومن بعد تشيك على الإصدار:
python3 -m pip install --upgrade compshare-cli
compshare --versionتأكد بلي الإصدار اللي خرج ماشي أقل من 0.3.5. تقدر تشوف مشروع CompShare CLI ومزيد من الشروحات فـ مستودع CompShare CLI على GitHub.
تثبيت إضافة MiniMax H3 Cloud
أولاً زِد مستودع المشروع لـ Codex Marketplace، ومن بعد ثبّت الإضافة المناسبة:
codex plugin marketplace add Sac-Y/MiniMax-H3-Cloud --ref main
codex plugin add minimax-h3-cloud@sac-y-minimax-h3ملي يكمل تنفيذ الأوامر، تقدر تستعمل MiniMax H3 Cloud فـ Codex. فأول تشغيل، الإضافة غادي تتبع الإرشادات باش تكمل إعداد بيانات الحساب، وGPU، ومعايير الفيديو.
مراحل الاستعمال الأول
- الدخول للمنصة السحابية: سجّل أو دخل ليويوان للحساب، وخبّي API Key محلياً فالجهاز باستعمال CLI الرسمي. ما تلصقش API Key فمحادثة Codex.
- اختيار GPU: شوف الثمن الآني والمخزون ديال GPU الحالية، واختار الإعداد اللي مناسب للحاجة والميزانية.
- إدخال معايير التوليد: قدّم الوصف النصي، وزيد الصور حسب طريقة التوليد، وحدد نسبة الأبعاد، والمدة، والوضوح.
- تأكيد المصاريف: راجع معايير الفيديو والمصاريف المتوقعة. غير من بعد التأكيد، الإضافة غادي تنشئ الموارد المؤدى عليها.
- انتظار التوليد: الإضافة غادي تجهز البيئة، وتنّفذ سير العمل، وتنزّل MP4 أوتوماتيكياً.
- مشاهدة النتيجة: من بعد ما تكمل المهمة، تقدر تشغل الفيديو فـ Codex وتنزّل ملف MP4.
أمثلة أساسية للاستعمال
هاد الأمثلة كتبيّن كيفاش تقدر تصيغ الطلبات فـ Codex. الاختيارات والإعدادات المتوفرة خاصها تبقى حسب الإرشادات اللي كتبان فأول تشغيل للإضافة.
المثال الأول: فيديو من النص
عيّط لـ MiniMax H3 Cloud وولّد فيديو ديال البحر وقت الغروب. الكاميرا تتحرك بشوية للقدّام، والموج يكون هادئ، والجو العام بألوان دافئة سينمائية. عاونّي نختار نسبة الأبعاد، والمدة، والوضوح، وGPU.الإضافة غادي تدخل فمسار جمع المعايير واختيار GPU حسب الطلب، وغادي تعرض المصاريف المتوقعة قبل إنشاء الموارد.
المثال الثاني: استعمال الإطار الأول والأخير
استعمل MiniMax H3 Cloud باش تولّد فيديو اعتماداً على الإطار الأول والأخير اللي غادي نعطيك. حافظ على نفس العنصر الرئيسي، وخلّيني نأكد معايير الفيديو والمصاريف المتوقعة قبل التنفيذ.طريقة الإطارات الرئيسية كتدعم غير الإطار الأول، أو غير الإطار الأخير، أو بجوج الإطارات.
المثال الثالث: استعمال عدة صور مرجعية
عيّط لـ MiniMax H3 Cloud واستعمل الصور المرجعية اللي غادي نعطيك باش تولّد فيديو، وعاونّي نكمل إعداد نسبة الأبعاد، والمدة، والوضوح، والقدرة الحاسوبية.طريقة توليد الفيديو من الصور المرجعية كتدعم من 1 حتى لـ 9 صور. قبل الإرسال، خاصك تتأكد بلي عدد الصور داخل فالنطاق المدعوم.
أماكن الإعدادات والنتائج
الإضافة كتكتب الإعدادات افتراضياً فـ:
~/.config/minimax-h3-cloud/config.jsonوالفيديوهات المولدة كيتحفظو افتراضياً فـ:
~/.local/share/minimax-h3-cloud/outputs/الجوج ديال المجلدات كاينين خارج مجلد تثبيت الإضافة، وبهذا ترقية الإضافة ما كتغطيش على الإعدادات والفيديوهات المولدة. ملي تحتاج تدير نسخة احتياطية، تقدر تنسخ الملفات المطلوبة من هاد المجلدات بشكل مستقل.
الاستعمال المتقدم والتنبيهات
قارن الثمن الآني والمخزون أولاً
ثمن ومخزون GPU السحابية كيتبدلو فالوقت الحقيقي. قبل بداية المهمة، خاصك تختار الإعداد حسب الميزانية، والمخزون، واحتياجات الفيديو. إلا ما كان حتى مورد مناسب، الإضافة غادي ترجع لمرحلة اختيار GPU، وما غاديش تبدل بصمت لإعداد ما أكدتيهش.
راجع معلومات تأكيد الأداء بعناية
الإضافة راسها ما كتخلصش، ولكن المنصة السحابية كتحاسب على GPU، وقرص النظام، والصورة، وموارد أخرى. قبل تأكيد إنشاء الموارد، خاصك تراجع GPU المختارة، والمصاريف المتوقعة، ومعايير الفيديو، باش تتفادى المصاريف غير الضرورية بسبب إعداد خاطئ.
استعمل الإيقاف الأوتوماتيكي للتحكم فالتكلفة
الإضافة كتوفّر افتراضياً إيقافاً احتياطياً من بعد 30 دقيقة، وكتوقف النسخة مباشرة من بعد ما كتسالي المهمة أو كتفشل. ومع ذلك، خاص المستخدم يبقى متابع حالة المهمة وصفحة الموارد فالمنصة السحابية، ويتأكد بلي النسخة توقفات كيفما متوقع.
ما تكشفش API Key فالمحادثة
خاص API Key يتحفظ محلياً فالجهاز باستعمال CompShare CLI، وما خاصوش يتبعت فمحادثة Codex، ولا فاللوغات، ولا فاللقطات، ولا فالأسئلة العمومية. المسار العادي ديال الإضافة ما كيطلبش إدخال بيانات الدخول فمحتوى الدردشة.
اختار طريقة التوليد حسب نوع الإدخال
- إلا كان عندك غير وصف إبداعي، استعمل الفيديو من النص.
- إلا بغيتي تتحكم فالمشهد الأول أو الأخير، استعمل الفيديو من الإطارات الرئيسية.
- إلا بغيتي تستعمل عدة مواد بصرية مرجعية، استعمل الفيديو من الصور المرجعية، وخلي عدد الصور بين 1 و9.
راجع رخصة النموذج قبل الاستعمال
كود الإضافة مستعمل برخصة MIT، ولكن النموذج وسير العمل عندهم شروط ترخيص خاصة بهم. بالإضافة لمراجعة MiniMax H3 Community License Agreement، خاصك تقرا حتى توضيحات تراخيص الأطراف الثالثة فالمستودع، وتتأكد بلي المنطقة والاستعمال ديالك متوافقين مع الشروط.
الأسئلة المتداولة
واش الإضافة فيها أوزان نموذج MiniMax H3؟
لا. README كيوضح بشكل صريح بلي المستودع ما كيوفرش أوزان نموذج MiniMax H3.
واش نقدر نستعملها فـ Windows؟
البيئات المدعومة المذكورة فـ README هي macOS أو Linux، وما كاين حتى تصريح بدعم Windows.
شنوما المنصات السحابية المدعومة دابا؟
حالياً كيدعم غير يويوان للحساب، والمشروع مخطط يزيد منصات أخرى من بعد.
إلا كانت GPU سالية، واش غادي تتبدل أوتوماتيكياً بإعداد آخر؟
لا. إلا ما تلقاش مورد مناسب، الإضافة غادي ترجع لمرحلة اختيار GPU، وما غاديش تبدل لإعداد آخر بلا تأكيد.
فين كيتحفظ الفيديو المولد؟
كيتحفظ افتراضياً فـ ~/.local/share/minimax-h3-cloud/outputs/.
الخلاصة
MiniMax H3 Cloud for Codex كتجمع اختيار GPU السحابية، وتجهيز ComfyUI Runtime، وتنفيذ سير عمل الفيديو، وتنزيل MP4، وإيقاف النسخة داخل مسار المحادثة فـ Codex. من بعد تثبيت التبعيات وإعداد بيانات الدخول محلياً، يقدر المستخدم يولّد فيديو باستعمال النص، أو الإطارات الرئيسية، أو من 1 حتى لـ 9 صور مرجعية. فالاستعمال الفعلي، خاص التركيز بالخصوص على رخصة النموذج، وأثمنة الموارد الآنية، وتأكيد الأداء، وسلامة API Key.