Özel Uç Noktalar#

Ultralytics Platform, YOLO modellerini dünya genelinde 42 bölgedeki tahsis edilmiş uç noktalara (dedicated endpoints) dağıtmayı sağlar. Her uç nokta; sıfıra ölçekleme (scale-to-zero) davranışına, benzersiz bir uç nokta URL'sine ve bağımsız izlemeye sahip tek kiracılı (single-tenant) bir servistir.

Uç Nokta Oluştur#

Dağıtım Sekmesinden#

Bir modeli Deploy sekmesinden dağıt:

1. Modeline git
2. Deploy (Dağıt) sekmesine tıkla
3. Bulunduğun konumdan ölçülen gecikmeye göre sıralanan dünya haritasını ve bölge tablosunu incele
4. Kullanmak istediğin bölge satırındaki Deploy seçeneğine tıkla

Dağıtım adı, model adından ve bölge şehrinden otomatik olarak oluşturulur (örn. yolo26n-iowa).

Dağıtımlar Sayfasından#

Kenar çubuğundaki genel Deploy sayfasından bir dağıtım oluştur:

1. New Deployment (Yeni Dağıtım) öğesine tıkla
2. Model seçiciden bir model seç
3. Haritadan veya tablodan bir bölge seç
4. Düzenlenebilir, otomatik oluşturulan dağıtım adını ve sabit kaynak varsayılanlarını gözden geçir
5. Deploy Model (Modeli Dağıt) öğesine tıkla

Dağıtım Yaşam Döngüsü#

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

    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff
    classDef error fill:#F44336,color:#fff
    classDef extern fill:#607D8B,color:#fff
    class Creating,Deploying,Stopping proc
    class Ready out
    class Failed error
    class Stopped extern

Bir dağıtım hazır olduğunda veya başlatılamadığında mesaj almak için Slack alerts bağlantısını kur.

Bölge Seçimi#

Dünya genelinde 42 bölge arasından seçim yap. İnteraktif bölge haritası ve tablo şunları gösterir:

• Bölge işaretçileri: Gecikmeye göre yeşilden kırmızıya renk kodlu (daha hızlı bölgeler yeşil, daha yavaş olanlar kırmızıdır)
• Dağıtılmış bölgeler: "Deployed" (Dağıtıldı) rozeti ile vurgulanmıştır
• Dağıtılan bölgeler: Animasyonlu nabız göstergesi
• Çift yönlü vurgulama: Harita üzerinde gezinmek tablo satırını vurgular ve tam tersi

Model Deploy sekmesindeki bölge tablosu şunları içerir:

Mevcut Bölgeler#

Uç Nokta Yapılandırması#

Yeni Dağıtım Diyaloğu#

New Deployment diyaloğu şunları sağlar:

Devre dışı bırakılan Resources paneli Coming Soon olarak işaretlenmiştir ve şu anda genişletilemez veya özelleştirilemez. Dağıtımlar 1 CPU, 2 GiB bellek, minInstances = 0 ve maxInstances = 1 kullanır.

Dağıtım Sekmesi (Hızlı Dağıtım)#

Modelin Deploy sekmesinden dağıtım yaparken, uç noktalar varsayılan kaynaklarla (1 CPU, 2 GB bellek) ve sıfıra ölçekleme etkinleştirilmiş olarak oluşturulur. Dağıtım adı otomatik olarak oluşturulur.

Uç Noktaları Yönet#

Görünüm Modları#

Dağıtımlar listesi üç görünüm modunu destekler:

Dağıtım Kartı (Kart Görünümü)#

Kart görünümündeki her dağıtım kartı şunları gösterir:

• Başlık: İsim, bölge bayrağı, durum rozeti, başlat/durdur/sil düğmeleri
• Uç Nokta URL'si: API dokümanlarına bağlantı içeren kopyalanabilir URL
• Metrikler: İstek sayısı (24s), P95 gecikme süresi, hata oranı
• Sağlık durumu: Gecikme süresi ve manuel yenileme içeren canlı sağlık göstergesi
• Sekmeler: Logs, Code ve Predict

Logs sekmesi, önem derecesi filtreleme (Tümü / Hatalar) ile son günlük girdilerini gösterir. Code sekmesi; gerçek uç nokta URL'n ve API anahtarın ile Python, JavaScript ve cURL dillerinde kullanıma hazır kod örnekleri gösterir. Predict sekmesi, doğrudan dağıtım üzerinde test yapma imkanı sunan satır içi bir tahmin (predict) paneli sağlar.

Dağıtım Durumları#

Uç Nokta URL'si#

Her uç noktanın benzersiz bir URL'si vardır, örneğin:

https://predict-abc123.run.app

URL'yi kopyalamak için kopyala düğmesine tıkla. Uç nokta için otomatik olarak oluşturulan API belgelerini görüntülemek üzere docs simgesine tıkla.

Yaşam Döngüsü Yönetimi#

Uç nokta durumunu kontrol et:

graph LR
    R[Ready]:::out -->|Stop| S[Stopped]:::extern
    S -->|Start| R
    R -->|Delete| D[Deleted]:::error
    S -->|Delete| D

    classDef out fill:#9C27B0,color:#fff
    classDef error fill:#F44336,color:#fff
    classDef extern fill:#607D8B,color:#fff

Uç Noktayı Durdur#

İstek kabul etmesini istemediğin bir uç noktayı durdur:

1. Dağıtım kartındaki duraklatma simgesine tıkla
2. Uç nokta durumu önce "Durduruluyor", sonra "Durduruldu" olarak değişir

Durdurulmuş uç noktalar:

• İstekleri kabul etmez
• İstenildiği zaman yeniden başlatılabilir

Uç Noktayı Sil#

Bir uç noktayı kalıcı olarak kaldır:

1. Dağıtım kartındaki silme (çöp kutusu) simgesine tıkla
2. İletişim kutusunda silme işlemini onayla

Uç Noktaları Kullanma#

Kimlik Doğrulama#

Her dağıtım, hesabından alınan bir API anahtarıyla oluşturulur. İsteklerine dahil et:

Authorization: Bearer YOUR_API_KEY

API anahtarı öneki, tanımlama amacıyla dağıtım kartının altbilgisinde görüntülenir. API Keys adresinden anahtar oluştur.

Doğrudan Uç Nokta İstekleri#

Üretim isteklerini doğrudan dağıtım kartında gösterilen URL'ye gönder. Bu istekler Platform API oran sınırlayıcısından geçmez. Uç nokta şu anda yukarıda açıklanan sabit kaynaklarla tek bir örnek çalıştırır.

İstek Örneği#

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

İstek Parametreleri#

Yanıt Formatı#

Göreve özel alanlarla shared inference ile aynıdır.

SSS#

Kaç uç nokta oluşturabilirim?#

Uç nokta sınırları plana bağlıdır:

• Ücretsiz: 3 dağıtıma kadar
• Pro: 10 dağıtıma kadar
• Kurumsal: Sınırsız dağıtım

Her model yine de plan kotan dahilinde birden fazla bölgeye dağıtılabilir.

Dağıtımdan sonra bölgeyi değiştirebilir miyim?#

Hayır, bölgeler sabittir. Bölgeleri değiştirmek için:

1. Mevcut uç noktayı sil
2. İstenen bölgede yeni bir uç nokta oluştur

Çok bölgeli dağıtımı nasıl yönetirim?#

Küresel kapsama alanı için:

1. Birden fazla bölgeye dağıt
2. Bir yük dengeleyici veya DNS yönlendirmesi kullan
3. Kullanıcıları en yakın uç noktaya yönlendir

Soğuk başlatma süresi nedir?#

Soğuk başlatma süresi, modele ve uç noktanın sıfıra ölçeklenip ölçeklenmediğine bağlıdır. Platform'un sağlık kontrolü isteği 55 saniyeye kadar izin verir, böylece boşta kalan bir uç noktanın başlamak için zamanı olur.

Her dağıtım şu anda kendi dağıtım kartında gösterilen oluşturulmuş uç nokta URL'sini kullanır.