پروجیکٹ کا تعارف
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کمانڈ مکمل ہونے کے بعد Codex میں MiniMax H3 Cloud استعمال کیا جا سکتا ہے۔ پہلی بار چلانے پر پلگ اِن رہنمائی کے ذریعے اکاؤنٹ کی اسناد، GPU کنفیگریشن اور ویڈیو پیرامیٹرز ترتیب دے گا۔
پہلی بار استعمال کا طریقہ
- کلاؤڈ پلیٹ فارم میں لاگ اِن کریں: 优云智算 پر رجسٹر یا لاگ اِن کریں، اور آفیشل CLI کے ذریعے API Key کو مقامی کمپیوٹر پر پوشیدہ طور پر محفوظ کریں۔ 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 License استعمال کرتا ہے، لیکن ماڈل اور ورک فلو کی اپنی لائسنس شرائط ہیں۔ 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 کی حفاظت پر خصوصی توجہ دینی چاہیے۔