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

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

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

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

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

1. انتقل إلى نموذجك
2. انقر على علامة التبويب نشر
3. Select a region from the interactive world map — regions are color-coded by latency from your location (green < 100ms, yellow < 200ms, red > 200ms)
4. انقر على نشر في صف المنطقة

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

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

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

1. انقر على نشر جديد
2. اختر طرازًا من محدد الطرازات
3. اختر منطقة من الخريطة أو الجدول
4. تخصيص اسم النشر والموارد اختياريًا
5. انقر على نشر النموذج

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

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 منطقة حول العالم. تُظهر خريطة وجدول المناطق التفاعليان:

• Region pins: Color-coded by latency (green < 100ms, yellow < 200ms, red > 200ms)
• المناطق المنشورة: مميزة بشارة "منشور"
• المناطق قيد النشر: مؤشر نبضي متحرك
• التمييز ثنائي الاتجاه: عند التمرير فوق الخريطة، يتم تمييز صف الجدول، والعكس صحيح

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

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

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

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

في New Deployment يوفر الحوار:

تتوفر إعدادات الموارد ضمن قسم الموارد القابل للطي. تستخدم عمليات النشر التوسع إلى الصفر بشكل افتراضي (الحد الأدنى للمثيلات = 0، الحد الأقصى للمثيلات = 1) — لا تدفع سوى مقابل وقت الاستدلال النشط.

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

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

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

أوضاع العرض

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

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

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

• الرأس: الاسم، علامة المنطقة، شارة الحالة، أزرار البدء/الإيقاف/الحذف
• عنوان 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] -->|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. تتغير حالة نقطة النهاية إلى "إيقاف" ثم "متوقف"

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

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

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

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

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

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

المصادقة

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

Authorization: Bearer YOUR_API_KEY

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

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

نقاط النهاية المخصصة غير خاضعة لقيود معدل استدعاء Platform 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())

// Build form data with image and parameters
const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("conf", "0.25");
formData.append("iou", "0.7");
formData.append("imgsz", "640");

// Send image for inference
const response = await fetch(
  "https://predict-abc123.run.app/predict",
  {
    method: "POST",
    headers: { Authorization: "Bearer YOUR_API_KEY" },
    body: formData,
  }
);

const result = await response.json();
console.log(result);

curl -X POST \
  "https://predict-abc123.run.app/predict" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@image.jpg" \
  -F "conf=0.25" \
  -F "iou=0.7" \
  -F "imgsz=640"

معلمات الطلب

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

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

التسعير

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

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

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

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

• مجاني: ما يصل إلى 3 عمليات نشر.
• احترافي: ما يصل إلى 10 عمليات نشر
• للمؤسسات: عمليات نشر غير محدودة

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

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

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

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

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

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

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

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

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

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

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

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

📅 تم الإنشاء قبل 2 أشهر ✏️ تم التحديث قبل 7 أيام

تعليقات