نقاط النهاية المخصصة#

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

إنشاء نقطة نهاية#

من علامة تبويب النشر#

انشر نموذجًا من علامة التبويب Deploy الخاصة به:

1. انتقل إلى نموذجك
2. انقر على علامة تبويب النشر
3. راجع خريطة العالم وجدول المناطق، المرتب حسب زمن الاستجابة المقاس من موقعك
4. انقر على نشر في صف المنطقة التي تريد استخدامها
5. راجع في مربع الحوار وحدة المعالجة المركزية والذاكرة والأسعار واسم النشر، ثم انقر على إنشاء عملية نشر

يجمع الاسم المقترح بين اسم النموذج ومدينة المنطقة (على سبيل المثال yolo26n-iowa)، ويمكن تعديله قبل النشر. يجب أن يتضمن النموذج أوزانًا، وإلا فستعرض علامة التبويب حالة فارغة بدلًا من جدول المناطق.

من علامة تبويب عمليات النشر#

أنشئ عملية نشر من علامة تبويب عمليات النشر في ملفك الشخصي أو من الشريط الجانبي:

1. انقر على عملية نشر جديدة في علامة تبويب عمليات النشر، أو على + بجوار عمليات النشر في الشريط الجانبي
2. حدد نموذجًا من محدد النماذج، الذي يعرض نماذجك المكتملة
3. حدد منطقة من الخريطة المصغرة أو جدول زمن الاستجابة
4. اختر وحدة المعالجة المركزية والذاكرة، وراجع الأسعار، وعدّل اسم النشر المقترح إذا لزم الأمر
5. انقر على إنشاء عملية نشر

دورة حياة النشر#

اربط تنبيهات Slack لتلقي رسالة عند جهوزية عملية نشر أو تعذّر بدء تشغيلها.

اختيار المنطقة#

اختر من بين 42 منطقة حول العالم. تعرض خريطة المناطق التفاعلية والجدول ما يلي:

• مؤشرات المناطق: ملوّنة بحسب زمن الاستجابة بتدرج من الأخضر إلى الأحمر (المناطق الأسرع أكثر خضرة، والأبطأ أكثر احمرارًا)
• المناطق المنشورة: مميزة بشارة «تم النشر» في الجدول
• المناطق قيد النشر: مؤشر نبضي متحرك على المؤشر وصف الجدول
• تمييز متبادل الاتجاهات: يؤدي تمرير المؤشر فوق الخريطة إلى تمييز صف الجدول، والعكس صحيح

يتضمن جدول المناطق في علامة تبويب النموذج Deploy ما يلي:

يمكن البحث في الجدول حسب المدينة والبلد والمنطقة، ويُرتّب افتراضيًا حسب زمن الاستجابة.

المناطق المتاحة#

إعداد نقطة النهاية#

مربع حوار نشر جديد#

يتيح لك مربع الحوار New Deployment تحديد نموذج ومنطقة وموارد واسم للنشر:

اختر حجم وحدة المعالجة المركزية والذاكرة من عناصر التحكم في الموارد، وراجع الأسعار المعروضة قبل إنشاء عملية النشر. خيارات وحدة المعالجة المركزية هي 1 أو 2 أو 4 أو 6 أو 8 vCPU، وتتراوح خيارات الذاكرة بين 2 و32 GiB؛ وتتطلب أحجام الذاكرة الأكبر عددًا أكبر من vCPU (على سبيل المثال، يتطلب حجم 16 GiB ما لا يقل عن 4 vCPU)، ويوضح مربع الحوار أي تركيبة غير صالحة. الحجم الافتراضي (1 vCPU و2 GiB) مجاني ويتقلص إلى الصفر عند الخمول. تُبقي الأحجام المخصصة نسخة واحدة قيد التشغيل، وتُحتسب تكلفتها وفق السعر الإقليمي بالساعة المعروض، بدءًا من جاهزية نقطة النهاية وحتى إيقافها، بما في ذلك وقت الخمول. يتطلب إنشاء حجم مخصص أو تشغيله أو تغيير حجمه توفر أرصدة، وتتوقف نقاط النهاية ذات الأحجام المخصصة تلقائيًا عند نفاد أرصدة مساحة العمل. يعيد الوكلاء استخدام مربع الحوار هذا عند تحديد نشر جديد….

علامة تبويب النشر (نشر سريع)#

يؤدي النشر من علامة تبويب النموذج Deploy إلى فتح مربع الحوار نفسه مع تحديد النموذج والمنطقة مسبقًا. راجع حجم الموارد والأسعار والاسم المُنشأ تلقائيًا قبل إنشاء نقطة النهاية. تظهر عملية النشر ضمن قائمة عمليات نشر النموذج أسفل جدول المناطق أثناء إنشائها.

إدارة نقاط النهاية#

أنماط العرض#

تدعم قائمة عمليات النشر ثلاثة أوضاع للعرض:

صفحة النشر#

لكل عملية نشر صفحة خاصة بها على /{username}/deploy/{deployment}، تعرض ما يلي:

• الرأس: علم المنطقة، واسم العرض (انقر عليه لإعادة تسميته؛ يتغير عنوان URL للصفحة ومسار API إلى مُعرّف مشتق من الاسم الجديد، بينما لا يتغير عنوان URL لنقطة النهاية)، وشارة الحالة، والموقع، وحجم وحدة المعالجة المركزية والذاكرة
• الإجراءات: تحديث الإعدادات واستبدال النموذج وإيقاف النشر عندما تكون الحالة جاهز، وبدء النشر عندما تكون الحالة متوقف، وقائمة مزيد من الإجراءات (…) التي تتضمن المعلومات وتحديث وحذف عملية النشر
• المقاييس: طلبات HTTP ومعدل أخطاء HTTP وكمون HTTP عند P95 على مدار 24 ساعة مع مخططات مصغرة، بالإضافة إلى بطاقة ترتبط بالنموذج المنشور
• علامات التبويب: Overview وMonitoring وPredict وLogs
• رسالة الحالة: سبب الإخفاق عند فشل عملية النشر

تعرض علامة التبويب Overview خريطة الموقع وبطاقة نقطة النهاية التي تتضمن عنوان URL لنقطة النهاية القابل للنسخ ورابط توثيق API وفحصًا لحالة السلامة، وبطاقة معلومات النشر التي تعرض الأسعار والمنطقة ووحدة المعالجة المركزية والذاكرة. تعرض علامة التبويب Logs أحدث إدخالات السجل مع إمكانية التصفية حسب مستوى الخطورة (الكل / الأخطاء). وتوفر علامة التبويب Predict لوحة تنبؤ مضمنة للاختبار مباشرة على عملية النشر؛ وتحتوي علامة تبويب نتيجة المستندات على أمثلة تعليمات برمجية جاهزة للاستخدام بلُغات Python وJavaScript وcURL، ومعبأة بعنوان URL لنقطة النهاية ومفتاح API المرتبط بها لأصحاب مساحة العمل (راجع المراقبة). ويعرض مربع حوار المعلومات خصائص عملية النشر ويتيح لك تعديل البيانات الوصفية المخصصة.

تحديث وحدة المعالجة المركزية والذاكرة#

1. افتح صفحة النشر لنقطة نهاية حالتها جاهز.
2. انقر على تحديث الإعدادات.
3. اختر وحدة المعالجة المركزية والذاكرة، وراجع التكلفة بالساعة المعروضة.
4. انقر على تحديث الإعدادات. يستمر الإعداد الحالي في تقديم الخدمة إلى أن يصبح الإعداد الجديد جاهزًا.

تُحتسب رسوم مدة تشغيل الموارد المخصصة وتُبقي مثيلًا جاهزًا، ما قد يتيح أيضًا تشغيل كاميرا IP دون رسوم إضافية (راجع كاميرا تعمل في الخلفية). تؤدي العودة إلى الموارد الافتراضية إلى استعادة سلوك التوسّع إلى الصفر وإزالة الكاميرا التي تعمل في الخلفية.

استبدال نموذج#

استبدل النموذج الذي تستخدمه نقطة نهاية جاهزة دون تغيير عنوان URL الخاص بها:

1. افتح صفحة النشر
2. انقر على استبدال النموذج
3. حدد نموذجًا مكتملًا آخر من مساحة العمل نفسها
4. يمكنك تعديل اسم النشر اختياريًا
5. انقر على استبدال النموذج

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

يتطلب الاستبدال استيفاء جميع الشروط التالية، وإلا فسيتم رفضه:

• حالة النشر جاهز، ولا توجد أي عملية أخرى من دورة الحياة قيد التنفيذ
• يحتوي النموذج البديل على أوزان وينتمي إلى مساحة العمل نفسها التي ينتمي إليها النشر
• النموذج البديل ليس النموذج المنشور حاليًا

حالات النشر#

في عملية نشر بحالة جاهز، تعرض شارة الصفحة جارٍ البدء إلى أن تستجيب نقطة النهاية لأول فحص سلامة، وتعرض لا تستجيب إذا فشل الفحص.

عنوان URL لنقطة النهاية#

لكل نقطة نهاية عنوان URL فريد، على سبيل المثال:

https://predict-<deployment-id>-<hash>-<region>.a.run.app

انقر على زر النسخ لنسخ عنوان URL. انقر على توثيق API لفتح مرجع API الخاص بنقطة النهاية. تخدم نقطة النهاية المسارات التالية:

إدارة دورة الحياة#

تحكّم في حالة نقطة النهاية:

إيقاف نقطة النهاية#

أوقف نقطة النهاية عندما لا تريدها أن تقبل الطلبات:

1. انقر على إيقاف النشر في صفحة النشر
2. تتغير حالة نقطة النهاية إلى «جارٍ الإيقاف» ثم «متوقف»

نقاط النهاية المتوقفة:

• لا تقبل الطلبات، ولا تعرض مقاييس مباشرة أو حالة سلامة
• تتوقف عن تراكم رسوم مدة التشغيل
• تفقد إحصاءات المراقبة المؤقتة والصور النموذجية عند إيقاف مثيل الخدمة
• تحتفظ بعناوين URL والمناطق ومفاتيح API المرتبطة بها، ويمكن إعادة تشغيلها في أي وقت
• تظل محسوبة ضمن حصة النشر في خطتك — احذف نقطة نهاية لتحرير خانتها

حذف نقطة النهاية#

إزالة نقطة نهاية نهائيًا:

1. افتح مزيد من الإجراءات (…) في صفحة النشر وانقر على حذف النشر، أو انقر على رمز سلة المهملات بجوار النشر في الشريط الجانبي
2. أكّد بالنقر على حذف

تُزال عمليات النشر أيضًا عند حذف نموذجها أو مشروعها نهائيًا، أو عند انتهاء فترة الاحتفاظ بنموذج أو مشروع في المهملات.

استخدام نقاط النهاية#

المصادقة#

ترتبط كل عملية نشر بمفتاح API واحد من مساحة العمل المالكة للنموذج. أدرج المفتاح في الطلبات:

Authorization: Bearer YOUR_API_KEY

لا تقبل نقطة النهاية سوى المفتاح المرتبط بها عند إنشائها، لذا لا يتيحها أي مفتاح آخر — ولا حتى مفتاح نشط آخر في مساحة العمل نفسها. للتحكم في المفتاح الذي سيُربط، انشر باستخدام API المصادق عليه بمفتاح مالك مساحة العمل: فذلك المفتاح بعينه هو الذي سيُربط، وهو بحوزتك بالفعل. أما عمليات النشر التي تُنشأ بأي طريقة أخرى (واجهة مستخدم Platform أو استدعاء API مصادق عليه بصفة أحد أعضاء الفريق)، فيُربط بها تلقائيًا أحد المفاتيح النشطة لمساحة العمل المالكة — اطلب قيمته من مالك مساحة العمل، إذ لا يمكن إلا للمالك الاطلاع على قيم المفاتيح (راجع مفاتيح API). ويظل بإمكان أعضاء الفريق الذين لا يملكون المفتاح المرتبط تشغيل الاستدلال عبر وسيط التنبؤ في المتصفح ضمن Platform.

الطلبات المباشرة إلى نقطة النهاية#

أرسل طلبات الإنتاج مباشرةً إلى عنوان URL الظاهر في صفحة النشر. لا تمر هذه الطلبات عبر محدِّد معدل الطلبات في Platform API، لذا لا ينطبق حد التنبؤ البالغ 20 طلبًا في الدقيقة. ومع ذلك، تخضع نقطة النهاية لحدّ السعة الخاص بها:

• يخدم كل نقطة نهاية مثيل واحد يعالج عددًا محدودًا من الطلبات في الوقت نفسه
• تُرجع الطلبات التي يتعذر تقديمها بسرعة 429 مع ترويسة Retry-After
• يمكن أن يستغرق تنفيذ الطلب الواحد مدة تصل إلى ساعة واحدة، ما يتيح اكتمال الاستدلال على الفيديو
• يقتصر حجم متن الطلب على 32 MB؛ وتُرفض التحميلات الأكبر مع 413
• تُضغط الاستجابات التي يتجاوز حجمها 1 KB باستخدام gzip، ويُسمح بطلبات المتصفح من مصادر مختلفة

مثال على طلب#

import requests

# ⁨نقطة نهاية النشر⁩
url = "https://YOUR_DEPLOYMENT_URL.run.app/predict"

# ⁨الترويسات التي تتضمن مفتاح API الخاص بالنشر⁩
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# ⁨معلمات الاستدلال⁩
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# ⁨إرسال صورة للاستدلال⁩
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

معلمات الطلب#

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

راجع استجابات العمق لمعرفة كيفية تأثير bits في خريطة العمق المُعادة وكيفية فك ترميزها.

تنسيق الاستجابة#

مماثل لـالاستدلال المشترك، مع حقول خاصة بالمهمة.

الأسئلة الشائعة#