شغّل عميل اختبار عامل استنتاج الوسائط بأمان

شنو هو media-inference-worker؟

media-inference-worker هو عميل اختبار قديم منسوخ من خط أنابيب ديال الوسائط. المثال الرئيسي الموثّق ديالو كيستعمل generate.py باش يرسل موجه نصّي لنقطة نهاية ولا نموذج ديال توليد الصور معرّف باسم qwen-image-3.

المستودع كينبّه باللي حساب الخدمة ديالو كان خدام ملي تنسخ المشروع، ولكن الرصيد المتبقي وحالة تدوير المفتاح ما معروفينش.

حيت هادا عميل اختبار قديم، تعامل مع الإعدادات وبيانات الاعتماد ديالو على أساس أنها ممكن تكون قديمة. راجع المصدر وإعدادات الحساب قبل ما ترسل الطلبات ولا تستعمل العميل فشي بيئة مشتركة ولا ديال الإنتاج.

المزايا الرئيسية

• كيقدّم سكريبت Python سميتو generate.py لإرسال طلب توليد.
• كيقبل نقطة نهاية ولا معرّف نموذج وموجه نصّي من سطر الأوامر.
• كيضمّن تبعيات Python فـ requirements.txt.
• كيوثّق نقاط نهاية إضافية وأمثلة ديال الطلبات الخام فـ RUNBOOK.md.

التثبيت والإعداد

1. راجع المستودع أولاً

حلّ المشروع محلياً وعاين generate.py وrequirements.txt وRUNBOOK.md. ملف README ما كيوضّحش فين مخزّنة بيانات الاعتماد ولا كيفاش مهيّأ التوثيق، لذلك تأكّد من هاد التفاصيل فملفات المشروع قبل ما تشغّل العميل.

2. تأكّد من بيانات اعتماد حساب الخدمة

ما تفترضش باللي المفتاح المنسوخ مازال صالح ولا مسموح ليك تستعملو. إلا كنت كتتحكّم فالحساب المرتابط به، تأكّد من الحالة ديالو، والرصيد المتاح، والصلاحيات، وحدود الفوترة. بدّل ولا ألغِ بيانات الاعتماد المكشوفة ولا اللي ما بقاتش ضرورية قبل ما تكمل.

3. أنشئ بيئة Python معزولة

استعمال بيئة افتراضية طريقة عملية باش تخلي تبعيات العميل منفصلة على مشاريع Python الأخرى.

python -m venv .venv
source .venv/bin/activate

فـ Windows، فعّل البيئة بهاد الأمر:

.venv\Scripts\activate

4. ثبّت التبعيات

من جذر المستودع، ثبّت الحزم اللي محددها المشروع:

pip install -r requirements.txt

الاستعمال الأساسي

ملف README كيقدّم مثال التوليد التالي:

python generate.py qwen-image-3 "Editorial portrait, hard flash, 35mm grain"

فهاد الأمر، generate.py هو سكريبت العميل، وqwen-image-3 هو نقطة النهاية ولا معرّف النموذج ديال الطلب، والنص بين علامتي الاقتباس هو موجه التوليد.

خلي الموجهات بين علامتي الاقتباس ملي يكونو فيهم مسافات ولا علامات ترقيم. مثلاً، الموجه الموثّق كيطلب بورتريه تحريري بفلاش قوي ولمسة حبيبات ديال 35 مم.

فهم بنية الأمر

python generate.py <endpoint-or-model> "<prompt>"

هاد البنية مستنتجة من المثال الوحيد فـ README. قبل ما تبدّل القيم، عاين generate.py ولا رجع لـ RUNBOOK.md باش تتأكّد من المعرّفات والوسائط اللي كيدعمها العميل.

الخدمة مع نقاط نهاية أخرى

README كايقول باللي نقاط النهاية الأخرى والطلبات الخام موثّقة فـ RUNBOOK.md. استعمل هاد الملف كمرجع خاص بالمشروع ملي تحتاج تجرّب شي حاجة كتفوت المثال الأساسي ديال qwen-image-3.

1. حلّ RUNBOOK.md.
2. لقا مثال نقطة النهاية ولا الطلب الخام المناسب.
3. تأكّد باللي تفاصيل التوثيق وصيغة الطلب مازالو محيّنين.
4. راجع التكاليف المتوقعة ولا استهلاك الرصيد قبل ما ترسل الطلب.
5. دير أصغر اختبار عملي قبل ما تحاول تدير عمليات متكررة ولا أكبر.

نصائح متقدمة وممارسات السلامة

عاين الطلبات قبل التنفيذ

حيت المستودع موصوف على أنه عميل قديم، راجع كيفاش generate.py كيبني وكيرسل الطلبات. تأكّد من الوجهة، والمحتوى المرسل، وطريقة التوثيق، وأي سلوك متعلق بكتابة الملفات قبل ما تنفّذو.

ما تعتمدش على بيانات اعتماد منسوخة

استعمل بيانات اعتماد مسموح ليك بالوصول ليها وتدبيرها. ما تودّعش الأسرار فـ التحكم فالمصدر، وما تنشرهاش فالسجلات، وما تفترضش باللي الحساب المذكور فـ README قديم مازال آمن للاستعمال.

تحقّق من توفر نقطة النهاية

أسماء نقاط النهاية القديمة، ولا مخططات الطلبات، ولا المفاتيح ممكن ما بقاوش خدامين. إلا فشل الأمر الموثّق، قارن التنفيذ مع RUNBOOK.md وتحقّق من إعدادات الحساب الحالية، بلا ما تعاود المحاولة بزاف مع طلب ممكن يتحسب عليه.

خلي الاختبارات تحت المراقبة

الرصيد المتبقي المجهول مصدر قلق مذكور بوضوح فـ README. راقب الاستعمال والفوترة إلى أمكن، وبدا بطلب واحد، وتفادى الحلقات الآلية حتى تفهم سلوك العميل والتكلفة ديالو.

الخلاصة

media-inference-worker كيقدّم عميل Python بسيط للاختبار ديال خط أنابيب الوسائط القديم. ثبّت المتطلبات ديالو، وراجع إعداد التوثيق، وشغّل مثال qwen-image-3 الموثّق غير من بعد ما تتأكّد من الصلاحية وحالة الرصيد. بالنسبة لنقاط النهاية الإضافية وأمثلة الطلبات ذات المستوى المنخفض، رجع لـ RUNBOOK.md.