Link to this sectionنقاط النهاية المخصصة#

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

Link to this sectionإنشاء نقطة نهاية#

Link to this sectionمن علامة تبويب النشر#

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

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

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

Link to this sectionمن صفحة عمليات النشر#

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

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

Link to this sectionدورة حياة النشر#

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

Link to this sectionاختيار المنطقة#

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

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

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

Link to this sectionالمناطق المتاحة#

Link to this sectionتهيئة نقطة النهاية#

Link to this sectionمربع حوار النشر الجديد#

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

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

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

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

Link to this sectionإدارة نقاط النهاية#

Link to this sectionأنماط العرض#

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

Link to this sectionبطاقة النشر (عرض البطاقات)#

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

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

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

Link to this sectionحالات النشر#

Link to this sectionعنوان URL لنقطة النهاية#

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

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

Link to this sectionإدارة دورة الحياة#

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

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

Link to this sectionإيقاف نقطة النهاية#

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

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

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

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

Link to this sectionحذف نقطة النهاية#

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

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

Link to this sectionاستخدام نقاط النهاية#

Link to this sectionالمصادقة#

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

Authorization: Bearer YOUR_API_KEY

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

Link to this sectionلا توجد حدود للمعدل#

الطلبات المرسلة مباشرةً إلى عنوان URL الخاص بنقطة النهاية المخصصة لديك لا تخضع لحدود معدل Platform API — حيث يتم تحديد معدل النقل فقط من خلال وحدة المعالجة المركزية (CPU) والذاكرة وإعدادات القياس لنقطة النهاية الخاصة بك. (الطلبات التي يتم توجيهها عبر Platform API، مثل أداة الاختبار داخل المتصفح، لا تزال تستخدم حد التنبؤ القياسي البالغ 20 طلباً/دقيقة). تُعد هذه ميزة رئيسية مقارنة بـ shared inference، والتي تقتصر على 20 طلباً/دقيقة لكل مفتاح API.

Link to this sectionمثال على الطلب#

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())

Link to this sectionمعلمات الطلب#

Link to this sectionتنسيق الاستجابة#

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

Link to this sectionالتسعير#

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

Link to this sectionالأسئلة الشائعة#

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

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

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

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

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

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

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

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

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

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

Link to this sectionما هو وقت البدء البارد؟#

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

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

Link to this sectionهل يمكنني استخدام نطاقات مخصصة؟#

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