مرحبًا بك في مكتبة Python الرسمية لـ RunPod API وSDK.
جدول المحتويات
|التثبيت
عامل بدون خادم (SDK)
بداية سريعة
عامل الاختبار المحلي
مكتبة لغة API (مغلف GraphQL)
نقاط النهاية
سحابة GPU (القرون)
دليل
المجتمع والمساهمة
# تثبيت أحدث إصدار pip install runpod# أو# تثبيت أحدث إصدار تطوير (الفرع الرئيسي)pip install git+https://github.com/runpod/runpod-python.git
مطلوب Python 3.8 أو أعلى لاستخدام أحدث إصدار من هذه الحزمة.
يمكن أيضًا استخدام حزمة python هذه لإنشاء عامل بدون خادم يمكن نشره على RunPod كواجهة برمجة تطبيقات مخصصة لنقطة النهاية.
قم بإنشاء برنامج نصي بيثون في مشروعك يحتوي على تعريف النموذج الخاص بك ورمز بدء تشغيل RunPod العامل. قم بتشغيل كود بايثون هذا كأمر بدء الحاوية الافتراضي الخاص بك:
# my_worker.pyimport runpoddef is_even(job):job_input = job["input"]the_number = job_input["number"]if not isinstance(the_number, int):return {"error": "إنسان سخيف، تحتاج إلى تمرير عدد صحيح."}if the_number % 2 == 0:return Truereturn Falserunpod.serverless.start({"handler": is_even})
تأكد من تشغيل هذا الملف عند بدء تشغيل الحاوية الخاصة بك. يمكن تحقيق ذلك عن طريق استدعائه في أمر docker عند إعداد قالب على runpod.io/console/serverless/user/templates أو عن طريق تعيينه كأمر افتراضي في ملف Dockerfile الخاص بك.
راجع منشور مدونتنا لإنشاء واجهة برمجة تطبيقات أساسية بدون خادم، أو راجع مستندات التفاصيل لمزيد من المعلومات.
يمكنك أيضًا اختبار عاملك محليًا قبل نشره على RunPod. وهذا مفيد لتصحيح الأخطاء والاختبار.
بايثون my_worker.py --rp_serve_api
عند التفاعل مع RunPod API، يمكنك استخدام هذه المكتبة لتقديم طلبات إلى API.
استيراد runpodrunpod.api_key = "your_runpod_api_key_found_under_settings"
يمكنك التفاعل مع نقاط نهاية RunPod عبر طريقة run
أو run_sync
.
نقطة النهاية = runpod.Endpoint("ENDPOINT_ID")run_request = endpoint.run( {"your_model_input_key": "your_model_input_value"} )# التحقق من حالة طلب تشغيل نقطة النهايةprint(run_request.status())# احصل على مخرجات طلب تشغيل نقطة النهاية، مع الحظر حتى اكتمال تشغيل نقطة النهاية.print(run_request.output())
نقطة النهاية = runpod.Endpoint("ENDPOINT_ID")run_request = endpoint.run_sync( {"your_model_input_key": "your_model_input_value"} )# إرجاع نتائج المهمة إذا تم إكمالها خلال 90 ثانية، وإلا فسيتم إرجاع حالة المهمة.print(run_request )
import runpodrunpod.api_key = "your_runpod_api_key_found_under_settings"# احصل على كل ما عندي من podspods = runpod.get_pods()# احصل على podpod محدد = runpod.get_pod(pod.id)# إنشاء podpod = runpod.create_pod("test", "runpod/stack" ", "NVIDIA GeForce RTX 3070")# أوقف podrunpod.stop_pod(pod.id)# استئناف podrunpod.resume_pod(pod.id)# إنهاء podrunpod.terminate_pod(pod.id)
.├── مستندات # وثائق├── أمثلة # أمثلة├── runpod # كود مصدر الحزمة│ ├── api_wrapper # مكتبة اللغة - API (GraphQL)│ ├── cli # وظائف واجهة سطر الأوامر│ ├── نقطة النهاية # مكتبة اللغات - نقاط النهاية│ └── بدون خادم # SDK - اختبارات العامل بدون خادم└── # اختبارات الحزمة
نحن نرحب بكل من طلبات السحب والمشكلات على GitHub. يتم تشجيع إصلاحات الأخطاء والميزات الجديدة، ولكن يرجى قراءة دليل المساهمة الخاص بنا أولاً.