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

تمكّن منصة Ultralytics نشر نماذج YOLO إلى نقاط نهاية مخصصة في 42 منطقة عالمية. كل نقطة نهاية هي خدمة أحادية المستأجر تتميز بسلوك التوسع إلى الصفر (scale-to-zero)، وعنوان URL فريد، ومراقبة مستقلة.

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

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

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

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

يتم إنشاء اسم النشر تلقائياً من اسم النموذج ومدينة المنطقة (على سبيل المثال، yolo26n-iowa).

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

قم بإنشاء عملية نشر من صفحة Deploy العالمية في الشريط الجانبي:

1. انقر فوق New Deployment
2. حدد نموذجاً من محدد النماذج
3. حدد منطقة من الخريطة أو الجدول
4. راجع اسم النشر القابل للتعديل والذي يتم إنشاؤه تلقائياً وقيم الموارد الثابتة الافتراضية
5. انقر فوق Deploy Model

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

stateDiagram-v2
    [*] --> Creating: Deploy
    Creating --> Deploying: Container starting
    Deploying --> Ready: Health check passed
    Ready --> Stopping: Stop
    Stopping --> Stopped: Stopped
    Stopped --> Ready: Start
    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 منطقة حول العالم. تعرض خريطة المناطق التفاعلية والجدول ما يلي:

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

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

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

تهيئة نقطة النهاية#

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

يوفر مربع الحوار New Deployment ما يلي:

تم وضع علامة Coming Soon على لوحة Resources المعطلة ولا يمكن توسيعها أو تخصيصها حالياً. تستخدم عمليات النشر 1 CPU، و2 GiB من الذاكرة، وminInstances = 0، وmaxInstances = 1.

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

عند النشر من علامة تبويب Deploy الخاصة بالنموذج، يتم إنشاء نقاط النهاية بموارد افتراضية (1 CPU، 2 GB ذاكرة) مع تفعيل ميزة التوسع إلى الصفر. يتم إنشاء اسم النشر تلقائياً.

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

أنماط العرض#

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

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

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

• الرأس: الاسم، علم المنطقة، شارة الحالة، أزرار البدء/الإيقاف/الحذف
• عنوان URL لنقطة النهاية: عنوان URL قابل للنسخ مع رابط لوثائق API
• المقاييس: عدد الطلبات (24 ساعة)، زمن الاستجابة P95، معدل الخطأ
• فحص الصحة: مؤشر صحة مباشر مع زمن الاستجابة والتحديث اليدوي
• علامات التبويب: Logs و Code و Predict

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

حالات النشر#

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

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

https://predict-abc123.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. تتغير حالة نقطة النهاية إلى "Stopping" ثم "Stopped"

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

• لا تقبل الطلبات
• يمكن إعادة تشغيلها في أي وقت

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

إزالة نقطة نهاية بشكل دائم:

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

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

المصادقة#

يتم إنشاء كل نشر باستخدام مفتاح API من حسابك. قم بتضمينه في الطلبات:

Authorization: Bearer YOUR_API_KEY

يتم عرض بادئة مفتاح API في تذييل بطاقة النشر للتعريف. قم بإنشاء المفاتيح من API Keys.

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

أرسل طلبات الإنتاج مباشرة إلى عنوان URL المعروض على بطاقة النشر. لا تمر هذه الطلبات عبر محدد معدل Platform API. تشغيل نقطة النهاية حالياً مثيل واحد بالموارد الثابتة المذكورة أعلاه.

مثال على الطلب#

import requests

# Deployment endpoint
url = "https://predict-abc123.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())

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

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

نفسه كما في shared inference مع حقول خاصة بالمهمة.

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

كم عدد نقاط النهاية التي يمكنني إنشاؤها؟#

تعتمد حدود نقاط النهاية على الخطة:

• Free: حتى 3 عمليات نشر
• Pro: حتى 10 عمليات نشر
• Enterprise: عمليات نشر غير محدودة

لا يزال من الممكن نشر كل نموذج في مناطق متعددة ضمن حصة خطتك.

هل يمكنني تغيير المنطقة بعد النشر؟#

لا، المناطق ثابتة. لتغيير المناطق:

1. احذف نقطة النهاية الحالية
2. أنشئ نقطة نهاية جديدة في المنطقة المطلوبة

كيف أتعامل مع النشر في مناطق متعددة؟#

للتغطية العالمية:

1. انشر في مناطق متعددة
2. استخدم موازن تحميل أو توجيه DNS
3. وجه المستخدمين إلى أقرب نقطة نهاية

ما هو وقت البدء البارد؟#

يعتمد وقت البدء البارد على النموذج وما إذا كانت نقطة النهاية قد تم تقليصها إلى الصفر. يسمح طلب التحقق من الصحة في Platform بما يصل إلى 55 ثانية لكي يحصل نقطة النهاية الخاملة على وقت للبدء.

تستخدم كل عملية نشر حالياً عنوان URL لنقطة النهاية الذي تم إنشاؤه والمعروض على بطاقة النشر الخاصة بها.