الاستدلال#

توفر Ultralytics Platform استدلالًا عبر المتصفح لاختبار النماذج المدرَّبة، ونقاط نهاية مخصصة للوصول البرمجي.

علامة تبويب التنبؤ#

يتضمن كل نموذج ذي أوزان علامة تبويب Predict للاستدلال عبر المتصفح:

1. انتقل إلى نموذجك
2. انقر فوق علامة التبويب Predict
3. حمّل صورة، أو استخدم مثالًا، أو افتح كاميرا الويب
4. راجع التراكب الخاص بالمهمة، وملخص التنبؤ، والتوقيت، والاستجابة الخام

تُظهر النماذج التي لا تحتوي على أوزان حالة فارغة بدلًا من ذلك — درِّب النموذج أو حمّل الأوزان أولًا.

طرق الإدخال#

تدعم لوحة التنبؤ طرق إدخال متعددة:

graph LR
    A[Upload Image]:::start --> D[Auto-Inference]:::proc
    B[Example Image]:::start --> D
    C[Webcam Capture]:::start --> D
    D --> E[Results + Overlays]:::out

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

تحميل صورة#

اسحب صورة وأفلتها أو انقر لتحميلها:

• التنسيقات المدعومة: JPEG، PNG، WebP، AVIF، HEIC، JP2، TIFF، BMP
• الحد الأقصى للحجم: 10 MB
• الاستدلال التلقائي: تظهر النتائج تلقائيًا بعد التحميل

صور المثال#

تعرض لوحة التنبؤ ما يصل إلى صورتين مثاليتين من مجموعة البيانات المرتبطة بنموذجك، مع تفضيل التقسيم val، ثم test، ثم train. إذا لم تكن هناك مجموعة بيانات مرتبطة، تُستخدم الأمثلة الافتراضية:

بالنسبة إلى نماذج OBB، تُعرض بدلًا من ذلك صور جوية لقوارب ومطار.

كاميرا الويب#

انقر فوق بطاقة كاميرا الويب لبدء بث مباشر من الكاميرا:

1. امنح إذن الوصول إلى الكاميرا عند مطالبتك بذلك
2. انقر فوق معاينة الفيديو لالتقاط إطار
3. يُجرى الاستدلال تلقائيًا على الإطار الملتقط
4. انقر مرة أخرى لإعادة تشغيل كاميرا الويب

عرض النتائج#

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

تُظهر لوحة النتائج ما يلي:

يوجد عنصران للتحكم فوق المعاينة بعد ظهور النتائج: انقر فوق الصورة لتكبيرها مع إبقاء التراكبات intact، واستخدم زر التنزيل لحفظ صورة JPEG مشروحة للنتيجة الحالية.

معلمات الاستدلال#

اضبط سلوك الاستدلال باستخدام أشرطة التمرير الثلاثة أسفل الصورة:

عتبة الثقة#

صفِّ التنبؤات حسب الثقة:

• أعلى (0.5+): تنبؤات أقل وأكثر يقينًا
• أقل (0.1-0.25): تنبؤات أكثر، مع بعض الضوضاء
• الافتراضية (0.25): متوازنة لمعظم حالات الاستخدام

عتبة IoU#

تحكّم في الإخماد غير الأقصى:

• أعلى (0.7+): السماح بمزيد من المربعات المتداخلة
• أقل (0.3-0.5): قمع الاكتشافات المتداخلة بدرجة أكبر
• الافتراضية (0.7): سلوك NMS متوازن لمعظم حالات الاستخدام

التنبؤ عبر النشر#

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

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

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

تحتوي بطاقة API Docs في علامة تبويب النموذج Predict على طلبات نموذجية باستخدام Python وJavaScript وcURL، مع تعبئتها مسبقًا بقيم الثقة وIoU وحجم الصورة المضبوطة حاليًا على أشرطة التمرير. يظل عنوان URL والمفتاح عنصرين نائبين إلى أن تنشر النموذج — وينقلك زر Deploy بجوار علامات تبويب التعليمات البرمجية إلى علامة تبويب النموذج Deploy. بعد النشر، تُعبّئ علامة تبويب Code في بطاقة النشر عنوان URL لنقطة النهاية هذه، ومفتاح API المرتبط بها لمالكي مساحة العمل، ويصبحان جاهزين للنسخ والتشغيل.

المصادقة#

ضمّن مفتاح API الخاص بك في الطلبات:

Authorization: Bearer YOUR_API_KEY

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

تستقبل نقاط النهاية المخصصة الطلبات على عنوان URL الخاص بها:

POST https://YOUR_DEPLOYMENT_URL.run.app/predict

يستخدم الاستدلال المشترك Platform API مع المسار الكامل للنموذج:

POST https://platform.ultralytics.com/api/models/{owner}/{project}/{model}/predict

يقبل كلاهما نص الطلب multipart/form-data نفسه ويعيدان بنية الاستجابة نفسها. باستخدام Python SDK، استخدم client.models.predict(owner, project, model, body=...) للاستدلال المشترك أو client.deployments.predict(owner, deployment, body=...) لنشر مخصص:

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
with open("image.jpg", "rb") as f:
    results = client.models.predict("acme-vision", "inspection", "v3", body={"file": f, "conf": 0.25})

الطلب#

import requests

url = "https://YOUR_DEPLOYMENT_URL.run.app/predict"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

with open("image.jpg", "rb") as image_file:
    response = requests.post(url, headers=headers, files={"file": image_file}, data=data)
print(response.json())

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

الاستجابة#

{
    "images": [
        {
            "shape": [1080, 1920],
            "results": [
                {
                    "class": 0,
                    "name": "person",
                    "confidence": 0.92,
                    "box": { "x1": 100, "y1": 50, "x2": 300, "y2": 400 }
                },
                {
                    "class": 2,
                    "name": "car",
                    "confidence": 0.87,
                    "box": { "x1": 400, "y1": 200, "x2": 600, "y2": 350 }
                }
            ],
            "speed": {
                "preprocess": 1.2,
                "inference": 12.5,
                "postprocess": 2.3
            }
        }
    ],
    "metadata": {
        "imageCount": 1,
        "functionTimeAlive": 1284.51,
        "functionTimeCall": 0.018,
        "task": "detect",
        "version": {
            "ultralytics": "8.x.x",
            "torch": "2.6.0",
            "torchvision": "0.21.0",
            "python": "3.13.0"
        }
    }
}

حقول الاستجابة#

الاستجابات الخاصة بالمهمة#

يختلف تنسيق الاستجابة باختلاف المهمة:

{
  "class": 0,
  "name": "person",
  "confidence": 0.92,
  "box": {"x1": 100, "y1": 50, "x2": 300, "y2": 400}
}

حدود معدل الطلبات#

تقتصر واجهة النماذج المشتركة على 20 طلبًا/دقيقة لكل مفتاح API أو متصل سجّل دخوله أو عنوان IP مجهول. عند تقييد المعدل، تعيد واجهة API القيمة 429 مع ترويسة Retry-After. راجع مرجع حدود المعدل الكامل لجميع فئات نقاط النهاية.

معالجة الأخطاء#

استجابات الأخطاء الشائعة:

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