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

تُمكّنك منصة Ultralytics من نشر نماذج YOLO إلى نقاط نهاية مخصصة في 43 منطقة عالمية. كل نقطة نهاية هي خدمة ذات مستأجر واحد مع خاصية التوسع إلى الصفر، وعنوان URL فريد، ومراقبة مستقلة.

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

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

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

1. انتقل إلى نموذجك
2. انقر على علامة تبويب Deploy
3. اختر منطقة من خريطة العالم التفاعلية - المناطق مرمزة بالألوان حسب زمن الوصول من موقعك (أخضر < 100 مللي ثانية، أصفر < 200 مللي ثانية، أحمر > 200 مللي ثانية)
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

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

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

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

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

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

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

حوار النشر الجديد

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

تستخدم عمليات النشر قيمًا افتراضية ثابتة هي 1 CPU و 2 GiB ذاكرة، مع minInstances = 0 و maxInstances = 1. وهي تتقلص إلى الصفر عند الخمول، لذا فأنت تدفع فقط مقابل وقت الاستدلال النشط.

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

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

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

أوضاع العرض

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

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

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

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

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

حالات النشر

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

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

انقر فوق زر النسخ لنسخ عنوان URL. انقر فوق أيقونة الوثائق لعرض وثائق API التي تم إنشاؤها تلقائياً لنقطة النهاية.

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

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

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

    style R fill:#4CAF50,color:#fff
    style S fill:#9E9E9E,color:#fff
    style D fill:#F44336,color:#fff

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

أوقف نقطة النهاية لإيقاف الفوترة مؤقتاً:

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

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

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

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

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

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

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

المصادقة

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

Authorization: Bearer YOUR_API_KEY

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

لا توجد حدود للأسعار

نقاط النهاية المخصصة لا تخضع لحدود معدل API الخاصة بالمنصة. تذهب الطلبات مباشرة إلى خدمتك المخصصة، لذا فإن الإنتاجية محدودة فقط بمعالج وحدة المعالجة المركزية (CPU) والذاكرة وتكوين القياس لنقطة النهاية الخاصة بك. هذه ميزة رئيسية مقارنة بـ الاستدلال المشترك، والذي يقتصر على 20 طلباً/دقيقة لكل مفتاح 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())

معلمات الطلب

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

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

التسعير

نقاط النهاية المخصصة الأساسية مجانية في جميع الخطط. ستوفر تكوينات الموارد الأعلى (المزيد من vCPUs، المزيد من الذاكرة، البدء الدافئ) تسعيراً يعتمد على الاستخدام في المستقبل.

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

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

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

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

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

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

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

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

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

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

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

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

يعتمد وقت البدء البارد على حجم النموذج وما إذا كانت الحاوية مخزنة مؤقتاً بالفعل في المنطقة. النطاقات النموذجية:

يستخدم فحص الحالة مهلة قدرها 55 ثانية لاستيعاب أسوأ حالات البدء البارد.

هل يمكنني استخدام نطاقات مخصصة؟

النطاقات المخصصة ستتوفر قريباً. حالياً، تستخدم نقاط النهاية روابط URL التي تم إنشاؤها بواسطة المنصة.