Ö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, adlandırma adımı olmaksızın hemen başlar: ad, model adından ve bölge şehrinden türetilir (örneğin yolo26n-iowa). Modelin ağırlıkları olmalıdır, aksi takdirde sekme bölge tablosu yerine boş bir durum gösterir.

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. Tamamlanan modellerini listeleyen model seçiciden bir model seç
3. Mini haritadan veya gecikme tablosundan bir bölge seç
4. Burada düzenleyebileceğin otomatik oluşturulan dağıtım adı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: Service starting
    Deploying --> Ready: Service URL published
    Ready --> Stopping: Stop
    Ready --> Deploying: Replace model
    Stopping --> Stopped: Stopped
    Stopped --> Deploying: Start
    Deploying --> Stopped: Start failed
    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ılan bölgeler: Tabloda "Deployed" rozetiyle vurgulanmıştır
• Dağıtılan bölgeler: İğne ve tablo satırında 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:

Tablo şehir, ülke ve bölgeye göre aranabilir ve varsayılan olarak gecikmeye göre sıralanır.

Mevcut Bölgeler#

Uç Nokta Yapılandırması#

Yeni Dağıtım Diyaloğu#

New Deployment diyaloğu üç girdi toplar:

Adın altında, salt okunur bir Resources paneli bir Custom resources coming soon rozeti taşır. Kaynaklar bugün yapılandırılamaz: her uç nokta, boşta kaldığında sıfıra ölçeklenen tek bir örnek olarak çalışır.

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

Modelin Deploy sekmesinden dağıtım yapmak, diyalog adımı olmaksızın aynı sabit kaynakları ve otomatik oluşturulan adı kullanır. Dağıtım, oluşturulurken bölge tablosunun altındaki Active Deployments listesinde hemen görünür.

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:

• Üst bilgi (Header): Ad, bölge bayrağı, durum rozeti ve mevcut durum için kullanılabilen eylem düğmeleri — Ready durumunda değiştir ve durdur, Stopped durumunda başlat, istendiğinde sil
• Uç Nokta URL'si (Endpoint URL): Uç noktanın kendi API referansına bağlantı içeren kopyalanabilir URL
• Metrikler: İstek sayısı (24s), P95 gecikmesi, hata oranı veya "Henüz trafik yok"
• Sağlık durumu: Gecikme süresi ve manuel yenileme içeren canlı sağlık göstergesi
• Sekmeler: Logs, Code ve Predict
• Alt bilgi (Footer): Dağıtıma bağlı API anahtarı öneki ve kullanıma hazır hale geldiği tarih
• Durum mesajı: Bir dağıtım başarısız olduğunda başarısızlık nedeni

URL, metrikler, sağlık kontrolü ve sekmeler yalnızca dağıtım Ready durumundayken görünür. Logs sekmesi, önem derecesi filtrelemesi (Tümü / Hatalar) ile son günlük girişlerini gösterir. Code sekmesi, uç nokta URL'niz ile Python, JavaScript ve cURL dilinde kullanıma hazır kod örneklerinin yanı sıra çalışma alanı sahipleri için bağlı API anahtarını gösterir (bkz. Monitoring). Predict sekmesi, doğrudan dağıtım üzerinde test yapmak için satır içi bir tahmin paneli sağlar.

Bir Modeli Değiştir#

URL'sini değiştirmeden hazır bir uç noktanın arkasındaki modeli değiştir:

1. Dağıtımı Cards görünümünde aç
2. Replace model düğmesine tıkla
3. Aynı çalışma alanından tamamlanmış başka bir model seç
4. İsteğe bağlı olarak dağıtım adını düzenle
5. Replace Model düğmesine tıkla

Mevcut model, değiştirme işlemi başlatılırken hizmet vermeye devam eder. Değiştirme hazır olduğunda trafik yeni modele taşınır. Dağıtım kimliği (ID), URL, bölge ve API anahtarı değişmeden kalır; görünen adı yalnızca yeni bir ad girdiğinde değişir. Değiştirme başarısız olursa önceki model ve ad etkin kalır.

Değiştirme, aşağıdakilerin tümünü gerektirir ve aksi takdirde reddedilir:

• Dağıtım Ready durumundadır ve devam eden başka bir yaşam döngüsü işlemi yoktur
• Değiştirilen modelin ağırlıkları vardır ve dağıtımla aynı çalışma alanına aittir
• Değiştirilen model halihazırda dağıtılmış olan model değildir

Dağıtım Durumları#

Uç Nokta URL'si#

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

https://predict-<deployment-id>-<hash>-<region>.a.run.app

URL'yi kopyalamak için kopyala düğmesine tıkla. Uç noktanın kendi API referansını açmak için belgeler simgesine tıkla. Uç nokta şu yollara hizmet eder:

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 ve herhangi bir metrik veya sağlık durumu bildirmez
• URL'lerini, bölgelerini ve bağlı API anahtarlarını korur ve istendiği zaman yeniden başlatılabilir
• Planının dağıtım kotasından düşmeye devam eder — yuvasını boşa çıkarmak için bir uç noktayı sil

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

Dağıtımlar ayrıca model veya projeleri kalıcı olarak silindiğinde ya da çöpe atılmış bir model veya proje saklama süresinin sonuna ulaştığında kaldırılır.

Uç Noktaları Kullanma#

Kimlik Doğrulama#

Her dağıtım, modelin sahibi olan çalışma alanından tek bir API anahtarına bağlıdır. Bunu isteklere dahil et:

Authorization: Bearer YOUR_API_KEY

Uç nokta yalnızca oluşturulurken bağlanan anahtarı kabul eder, bu nedenle başka hiçbir anahtar onu açamaz — aynı çalışma alanındaki başka bir aktif anahtar bile. Hangi anahtarın bağlanacağını kontrol etmek için çalışma alanı sahibinin anahtarıyla kimlik doğrulaması yapılmış API üzerinden dağıtın: tam olarak o anahtar bağlanır ve buna zaten sahipsiniz. Başka bir şekilde (Platform arayüzü veya bir ekip üyesi olarak kimlik doğrulaması yapılmış bir API çağrısı) oluşturulan dağıtımlar, sahibi olan çalışma alanının aktif anahtarlarından birini otomatik olarak bağlar; bunu dağıtım kartı alt bilgisinde gösterilen anahtar önekinden tanıyabilir ve anahtar değerlerini yalnızca sahip görebileceği için değerini çalışma alanı sahibinden isteyebilirsiniz (bkz. API Keys). Bağlı anahtara sahip olmayan ekip üyeleri, tarayıcıdaki Platform tahmin proxy'si aracılığıyla yine de çıkarım çalıştırabilir.

Doğrudan Uç Nokta İstekleri#

Üretim isteklerini doğrudan dağıtım kartında gösterilen URL'ye gönderin. Bu istekler Platform API hız sınırlayıcısından geçmez, bu nedenle dakikada 20 istek olan tahmin sınırı geçerli değildir. Uç noktanın yine de kendi kapasite sınırı vardır:

• Her uç noktaya tek bir örnek hizmet verir ve aynı anda sınırlı sayıda isteği işler
• Derhal sunulamayan istekler, bir Retry-After üst bilgisiyle birlikte 429 döndürür
• Tek bir istek 1 saate kadar çalışabilir, bu da video çıkarımının tamamlanmasına olanak tanır
• 1 KB'den büyük yanıtlar gzip ile sıkıştırılır ve siteler arası tarayıcı isteklerine izin verilir

İstek Örneği#

import requests

# Deployment endpoint
url = "https://YOUR_DEPLOYMENT_URL.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#

bits öğesinin döndürülen derinlik haritasını nasıl değiştirdiğini ve nasıl çözüleceğini öğrenmek için Depth responses sayfasına bakın.

Yanıt Formatı#

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

SSS#