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

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

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

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

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

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

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

من صفحة عمليات النشر#

أنشئ عملية نشر من الصفحة العامة Deploy في الشريط الجانبي:

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

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

stateDiagram-v2
    [*] --> Creating: Deploy
    Creating --> Deploying: Service starting
    Deploying --> Ready: Service URL published
    Ready --> Stopping: Stop
    Ready --> Deploying: Replace model
    Stopping --> Stopped: Stopped
    Stopped --> Deploying: Start
    Deploying --> Stopped: Start failed
    Ready --> [*]: Delete
    Stopped --> [*]: Delete
    Creating --> Failed: Error
    Deploying --> Failed: Error
    Failed --> [*]: Delete

    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff
    classDef error fill:#F44336,color:#fff
    classDef extern fill:#607D8B,color:#fff
    class Creating,Deploying,Stopping proc
    class Ready out
    class Failed error
    class Stopped extern

اربط تنبيهات Slack لتلقي رسالة عندما تصبح عملية النشر جاهزة أو تفشل في البدء.

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

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

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

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

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

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

تكوين نقطة النهاية#

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

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

اختر وحدة المعالجة المركزية وحجم الذاكرة في عناصر تحكم الموارد وراجع التسعير المعروض قبل إنشاء النشر. يمكن أن يستخدم الحجم الافتراضي مخصص تخصيص نشر مجاني متاح؛ بينما تستخدم الأحجام المخصصة تسعيرًا مقاسًا. يتغير حجم الحجم الافتراضي إلى الصفر عند الخمول. تحتفظ الأحجام المخصصة بنسخة دافئة واحدة ويتم محاسبتها بدءًا من الجاهزية حتى تقوم بإيقاف نقطة النهاية، بما في ذلك وقت الخمول. تعمل Agents على إعادة استخدام مربع الحوار هذا عند تحديد New deployment….

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

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

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

أوضاع العرض#

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

بطاقة النشر (عرض البطاقات)#

تعرض كل بطاقة نشر في عرض البطاقات ما يلي:

• الرأس: الاسم، وعلم المنطقة، وشارة الحالة، وأزرار الإجراءات المتاحة للحالة الحالية — تحديث التكوين، والاستبدال، والإيقاف عندما يكون جاهزاً (Ready)، والبدء عندما يكون متوقفاً (Stopped)، والحذف في أي وقت
• عنوان URL لنقطة النهاية: عنوان URL قابل للنسخ مع رابط إلى مرجع API الخاص بنقطة النهاية
• المقاييس: عدد الطلبات (24 ساعة)، وزمن الاستجابة P95، ومعدل الأخطاء، أو «لا توجد حركة مرور بعد»
• فحص السلامة: مؤشر سلامة مباشر مع زمن الاستجابة وخيار التحديث اليدوي
• علامات التبويب: Logs، وCode، وPredict؛ وتظهر نقاط النهاية المدفوعة أيضاً Monitoring
• التذييل: بادئة مفتاح API المرتبط بالنشر وتاريخ جاهزيته
• رسالة الحالة: سبب الفشل عند فشل النشر

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

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

1. افتح نقطة نهاية جاهزة (Ready) في عرض البطاقات (Cards).
2. انقر فوق تحديث تكوين النشر (Update deployment configuration).
3. اختر وحدة المعالجة المركزية (CPU) والذاكرة (Memory)، وراجع التكلفة بالساعة المعروضة.
4. انقر فوق تحديث التكوين (Update Configuration). يستمر التكوين الحالي في تقديم الخدمة حتى يصبح التكوين الجديد جاهزاً.

تستخدم الموارد المخصصة فوترة وقت التشغيل وتحافظ على مثيل دافئ. يؤدي العودة إلى الموارد الافتراضية إلى استعادة سلوك القياس إلى الصفر وإزالة علامة تبويب المراقبة المدفوعة.

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

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

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

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

يتطلب الاستبدال جميع الشروط التالية، ويُرفض بخلاف ذلك:

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

حالات النشر#

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

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

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

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

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

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

graph LR
    R[Ready]:::out -->|Stop| S[Stopped]:::extern
    S -->|Start| R
    R -->|Delete| D[Deleted]:::error
    S -->|Delete| D

    classDef out fill:#9C27B0,color:#fff
    classDef error fill:#F44336,color:#fff
    classDef extern fill:#607D8B,color:#fff

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

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

1. انقر على أيقونة الإيقاف المؤقت في بطاقة النشر
2. تتغير حالة نقطة النهاية إلى "جارٍ الإيقاف" ثم "متوقفة"

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

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

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

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

1. انقر على أيقونة الحذف (سلة المهملات) في بطاقة النشر
2. أكد الحذف في مربع الحوار

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

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

المصادقة#

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

Authorization: Bearer YOUR_API_KEY

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

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

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

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

مثال على طلب#

import requests

# Deployment endpoint
url = "https://YOUR_DEPLOYMENT_URL.run.app/predict"

# Headers with your deployment API key
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Inference parameters
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# Send image for inference
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

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

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

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

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

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