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

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

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

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

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

1. انتقل إلى نموذجك
2. انقر على علامة التبويب نشر
3. حدد منطقة من جدول المناطق (مرتبة حسب زمن الاستجابة من موقعك)
4. انقر فوق "نشر " في صف المنطقة

يتم إنشاء اسم النشر تلقائيًا من اسم النموذج ومدينة المنطقة (على سبيل المثال، yolo11n-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.

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

لا تخضع نقاط النهاية المخصصة لحدود معدل 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 التي تنشئها المنصة.

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

تعليقات