نقاط النهاية المخصصة
منصة Ultralytics تتيح نشر نماذج YOLO إلى نقاط نهاية مخصصة في 43 منطقة عالمية. كل نقطة نهاية هي خدمة أحادية المستأجر مع التوسع التلقائي وعناوين URL مخصصة ومراقبة مستقلة.
إنشاء نقطة نهاية
نشر نموذج إلى نقطة نهاية مخصصة:
- انتقل إلى نموذجك
- انقر على علامة التبويب نشر
- حدد منطقة من الخريطة
- انقر على نشر
اختيار المنطقة
اختر من بين 43 منطقة حول العالم:
تُظهر الخريطة التفاعلية:
- علامات المناطق: انقر للتحديد
- مؤشرات زمن الاستجابة: مرمزة بالألوان حسب المسافة
- Green: <100ms
- أصفر: 100-200 مللي ثانية
- أحمر: >200 مللي ثانية
جدول المناطق
عرض جميع المناطق بالتفاصيل:
| العمود | الوصف |
|---|---|
| المنطقة | معرف المنطقة |
| الموقع | المدينة/البلد |
| الكمون | زمن استجابة البينج المقاس |
| الحالة | متاح/منشور |
اختر بحكمة
اختر المنطقة الأقرب لمستخدميك للحصول على أقل زمن استجابة. فكر في النشر في مناطق متعددة لتغطية عالمية.
المناطق المتاحة
الأمريكتان (14 منطقة)
| المنطقة | الموقع |
|---|---|
| us-central1 | آيوا، الولايات المتحدة الأمريكية |
| us-east1 | كارولينا الجنوبية، الولايات المتحدة الأمريكية |
| us-east4 | فيرجينيا، الولايات المتحدة الأمريكية |
| us-east5 | أوهايو، الولايات المتحدة الأمريكية |
| us-west1 | أوريغون، الولايات المتحدة الأمريكية |
| us-west2 | لوس أنجلوس، الولايات المتحدة الأمريكية |
| us-west3 | سولت ليك سيتي، الولايات المتحدة الأمريكية |
| us-west4 | لاس فيغاس، الولايات المتحدة الأمريكية |
| us-south1 | دالاس، الولايات المتحدة الأمريكية |
| northamerica-northeast1 | مونتريال، كندا |
| northamerica-northeast2 | تورونتو، كندا |
| أمريكا الجنوبية - شرق 1 | ساو باولو، البرازيل |
| أمريكا الجنوبية - غرب 1 | سانتياغو، تشيلي |
أوروبا (12 منطقة)
| المنطقة | الموقع |
|---|---|
| أوروبا-غرب1 | بلجيكا |
| أوروبا-غرب2 | لندن، المملكة المتحدة |
| أوروبا-غرب3 | فرانكفورت، ألمانيا |
| أوروبا-غرب4 | هولندا |
| أوروبا-غرب6 | زيورخ، سويسرا |
| أوروبا-غرب8 | ميلانو، إيطاليا |
| أوروبا-غرب9 | باريس، فرنسا |
| أوروبا-غرب10 | برلين، ألمانيا |
| أوروبا-غرب12 | تورينو، إيطاليا |
| أوروبا - شمال 1 | فنلندا |
| أوروبا - وسط 2 | وارسو، بولندا |
| أوروبا - جنوب غرب 1 | مدريد، إسبانيا |
آسيا والمحيط الهادئ (14 منطقة)
| المنطقة | الموقع |
|---|---|
| آسيا - شرق 1 | تايوان |
| آسيا - شرق 2 | هونغ كونغ |
| آسيا - شمال شرق 1 | طوكيو، اليابان |
| asia-northeast2 | أوساكا، اليابان |
| asia-northeast3 | سيول، كوريا الجنوبية |
| asia-south1 | مومباي، الهند |
| asia-south2 | دلهي، الهند |
| asia-southeast1 | سنغافورة |
| asia-southeast2 | جاكرتا، إندونيسيا |
| australia-southeast1 | سيدني، أستراليا |
| australia-southeast2 | ملبورن، أستراليا |
الشرق الأوسط وأفريقيا (3 مناطق)
| المنطقة | الموقع |
|---|---|
| me-central1 | الدوحة، قطر |
| me-central2 | الدمام، المملكة العربية السعودية |
| me-west1 | تل أبيب، إسرائيل |
تهيئة نقطة النهاية
عند إنشاء نقطة نهاية:
| إعداد | الوصف | افتراضي |
|---|---|---|
| المنطقة | منطقة النشر | - |
| الحد الأدنى للمثيلات | الحد الأدنى للمثيلات قيد التشغيل | 0 |
| الحد الأقصى للمثيلات | الحد الأقصى لقابلية التوسع | 10 |
خيارات التوسع
| إعداد | السلوك |
|---|---|
| الحد الأدنى = 0 | التوسع إلى الصفر عند الخمول (فعال من حيث التكلفة) |
| الحد الأدنى > 0 | يعمل دائمًا لتجنب بدء التشغيل البارد |
| الحد الأقصى | الحد الأعلى لارتفاعات حركة المرور |
بدء التشغيل البارد
عندما يكون الحد الأدنى للمثيلات = 0، فإن الطلب الأول بعد الخمول يؤدي إلى بدء تشغيل بارد (يستغرق 2-5 ثوانٍ). اضبط الحد الأدنى > 0 للتطبيقات الحساسة لوقت الاستجابة.
إدارة نقاط النهاية
عرض وإدارة نقاط النهاية الخاصة بك:
تفاصيل نقطة النهاية
| الحقل | الوصف |
|---|---|
| عنوان URL | نقطة نهاية HTTPS للطلبات |
| المنطقة | المنطقة التي تم النشر فيها |
| الحالة | قيد التشغيل، متوقف، قيد النشر |
| المثيلات | العدد الحالي/الأقصى للمثيلات |
عنوان URL لنقطة النهاية
لكل نقطة نهاية عنوان URL فريد:
https://model-abc123-us-central1.a.run.app
انقر على زر النسخ لنسخ عنوان URL.
إدارة دورة الحياة
التحكم في حالة نقطة النهاية الخاصة بك:
| الإجراء | الوصف |
|---|---|
| بدء | استئناف نقطة نهاية متوقفة |
| إيقاف | إيقاف نقطة النهاية مؤقتًا (بدون فواتير) |
| حذف | إزالة نقطة النهاية بشكل دائم |
إيقاف نقطة النهاية
لإيقاف نقطة نهاية وإيقاف الفوترة مؤقتًا:
- افتح قائمة إجراءات نقطة النهاية
- انقر على إيقاف
- تأكيد الإجراء
نقاط النهاية المتوقفة:
- لا تقبل الطلبات
- لا تتكبد رسومًا
- يمكن إعادة تشغيلها في أي وقت
حذف نقطة النهاية
لإزالة نقطة نهاية بشكل دائم:
- افتح قائمة إجراءات نقطة النهاية
- انقر على حذف
- تأكيد الحذف
إجراء دائم
الحذف فوري ودائم. يمكنك دائمًا إنشاء نقطة نهاية جديدة.
استخدام نقاط النهاية
المصادقة
قم بتضمين مفتاح API الخاص بك في الطلبات:
Authorization: Bearer YOUR_API_KEY
مثال على الطلب
curl -X POST \
"https://model-abc123-us-central1.a.run.app/predict" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@image.jpg"
import requests
url = "https://model-abc123-us-central1.a.run.app/predict"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
files = {"file": open("image.jpg", "rb")}
response = requests.post(url, headers=headers, files=files)
print(response.json())
تنسيق الاستجابة
مماثل لـ الاستدلال المشترك مع حقول خاصة بالمهمة.
التسعير
يتم احتساب فواتير نقاط النهاية المخصصة بناءً على:
| مكون | السعر |
|---|---|
| وحدة المعالجة المركزية (CPU) | لكل ثانية vCPU |
| الذاكرة | لكل جيجابايت-ثانية |
| الطلبات | لكل مليون طلب |
تحسين التكلفة
- استخدم التوسع إلى الصفر لنقاط نهاية التطوير
- عيّن الحد الأقصى المناسب من المثيلات
- راقب الاستخدام في لوحة معلومات المراقبة
الأسئلة الشائعة
كم عدد نقاط النهاية التي يمكنني إنشاؤها؟
لا يوجد حد صارم. يمكن لكل نموذج أن يحتوي على نقاط نهاية في مناطق متعددة. إجمالي نقاط النهاية يعتمد على خطتك.
هل يمكنني تغيير المنطقة بعد النشر؟
لا، المناطق ثابتة. لتغيير المناطق:
- احذف نقطة النهاية الحالية
- إنشاء نقطة نهاية جديدة في المنطقة المطلوبة
كيف أتعامل مع النشر متعدد المناطق؟
للتغطية العالمية:
- النشر في مناطق متعددة
- استخدام موازن تحميل أو توجيه DNS
- توجيه المستخدمين إلى أقرب نقطة نهاية
ما هو وقت البدء البارد؟
يختلف البدء البارد حسب حجم النموذج:
| النموذج | البدء البارد |
|---|---|
| YOLO26n | حوالي ثانيتين |
| YOLO26m | حوالي 3 ثوانٍ |
| YOLO26x | حوالي 5 ثوانٍ |
اضبط الحد الأدنى من المثيلات > 0 للتخلص من حالات البدء البارد.
هل يمكنني استخدام نطاقات مخصصة؟
النطاقات المخصصة قادمة قريبًا. حاليًا، تستخدم نقاط النهاية عناوين URL التي تنشئها المنصة.
