Özel uç noktalar#

Ultralytics Platform, YOLO modellerini dünya genelindeki 42 bölgede bulunan özel uç noktalara dağıtmanı sağlar. Her uç nokta, benzersiz bir uç nokta URL'sine ve bağımsız izlemeye sahip tek kiracılı bir hizmettir. Varsayılan kaynak boyutu boşta kaldığında sıfıra iner; özel boyutlar çalışan bir örneği hazır tutar ve çalışma süresi boyunca ücretlendirilir.

Uç Nokta Oluştur#

Deploy Sekmesinden#

Modeli Deploy sekmesinden dağıt:

1. Modeline git
2. Deploy sekmesine tıkla
3. Dünya haritasını ve bulunduğun konuma göre ölçülen gecikme süresine göre sıralanmış bölge tablosunu incele
4. Kullanmak istediğin bölgenin satırındaki Deploy düğmesine tıkla
5. İletişim kutusunda CPU, belleği, fiyatlandırmayı ve dağıtım adını incele; ardından Create Deployment düğmesine tıkla

Önerilen ad, model adını ve bölge şehrini birleştirir (örneğin yolo26n-iowa) ve dağıtımdan önce düzenlenebilir. Modelin ağırlıkları olmalıdır; aksi takdirde sekmede bölge tablosu yerine boş durum gösterilir.

Deployments Sekmesinden#

Profilindeki Deployments sekmesinden veya kenar çubuğundan dağıtım oluştur:

1. Deployments sekmesinde New Deployment düğmesine veya kenar çubuğunda Deployments yanındaki + öğesine tıkla
2. Tamamlanmış modellerini listeleyen model seçiciden bir model seç
3. Mini haritadan veya gecikme tablosundan bir bölge seç
4. CPU ve belleği seç, fiyatlandırmayı incele ve gerekirse önerilen dağıtım adını düzenle
5. Create Deployment düğmesine tıkla

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

Bir dağıtım hazır olduğunda veya başlatılamadığında mesaj almak için Slack uyarılarını bağla.

Bölge Seçimi#

Dünya genelindeki 42 bölgeden birini seç. Etkileşimli bölge haritası ve tablo şunları gösterir:

• Bölge işaretçileri: Gecikme süresine göre yeşilden kırmızıya uzanan bir renk skalasıyla kodlanır (daha hızlı bölgeler daha yeşil, daha yavaş bölgeler daha kırmızıdır)
• Dağıtılmış bölgeler: Tabloda "Deployed" rozetiyle vurgulanır
• Dağıtım sürecindeki bölgeler: İşaretçide ve tablo satırında animasyonlu nabız göstergesi bulunur
• Çift yönlü vurgulama: Haritanın üzerine gelince tablo satırı, tablo satırının üzerine gelince haritadaki bölge vurgulanır

Modelin Deploy sekmesindeki bölge tablosunda şunlar bulunur:

Tabloda şehir, ülke ve bölge koduna göre arama yapabilir; varsayılan olarak gecikme süresine göre sıralayabilirsin.

Kullanılabilir Bölgeler#

Uç Nokta Yapılandırması#

Yeni Dağıtım İletişim Kutusu#

New Deployment iletişim kutusu; model, bölge, kaynaklar ve dağıtım adı seçmene olanak tanır:

Dağıtımı oluşturmadan önce kaynaklar kontrollerinden CPU ve bellek boyutunu seç ve görüntülenen fiyatı incele. CPU seçenekleri 1, 2, 4, 6 veya 8 vCPU; bellek seçenekleri ise 2 ila 32 GiB arasındadır. Daha büyük bellek boyutları daha fazla vCPU gerektirir (örneğin, 16 GiB için en az 4 vCPU gerekir) ve iletişim kutusu geçersiz kombinasyonları açıklar. Varsayılan boyut (1 vCPU, 2 GiB) ücretsizdir ve boşta kaldığında sıfıra ölçeklenir. Özel boyutlar bir örneği sürekli hazır tutar ve uç nokta hazır olduğundan sen durdurana kadar, boşta kalma süresi de dâhil olmak üzere, görüntülenen bölgesel saatlik ücret üzerinden faturalandırılır. Özel boyut oluşturmak, başlatmak veya yeniden boyutlandırmak için kullanılabilir kredin olmalıdır; çalışma alanında kredi kalmadığında özel boyutlu uç noktalar otomatik olarak durdurulur. Aracılar, Yeni dağıtım… seçtiğinde bu iletişim kutusunu yeniden kullanır.

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

Modelin Deploy sekmesinden dağıtım yapmak, model ve bölge önceden seçilmiş olarak aynı iletişim kutusunu açar. Uç noktayı oluşturmadan önce kaynak boyutunu, fiyatı ve otomatik oluşturulan adı incele. Dağıtım oluşturulurken bölge tablosunun altındaki model dağıtımları listesinde görünür.

Uç Noktaları Yönetme#

Görünüm Modları#

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

Dağıtım Sayfası#

Her dağıtımın /{username}/deploy/{deployment} adresinde kendine ait bir sayfası vardır. Bu sayfada şunlar gösterilir:

• Üstbilgi: Bölge bayrağı, görünen ad (yeniden adlandırmak için tıkla; sayfa URL'si ve API yolu yeni adın kısa biçimiyle değişir, uç nokta URL'si değişmez), durum rozeti, konum ve CPU ile bellek boyutu
• İşlemler: Durum Hazır olduğunda Yapılandırmayı güncelle, Modeli değiştir ve Dağıtımı durdur; durum Durduruldu olduğunda Dağıtımı başlat ve Bilgi, Yenile ve Dağıtımı sil seçeneklerini içeren bir Diğer işlemler (…) menüsü
• Metrikler: 24 saatlik HTTP İstekleri, HTTP Hata Oranı ve HTTP P95 Gecikmesi; bunlara ek olarak küçük grafikler ve dağıtılan modele bağlantı veren bir kart
• Sekmeler: Overview, Monitoring, Predict ve Logs
• Durum mesajı: Dağıtım başarısız olduğunda başarısızlık nedeni

Overview sekmesinde konum haritası, kopyalanabilir uç nokta URL'si içeren Uç Nokta kartı, bir API dokümantasyonu bağlantısı ve sağlık denetimi ile fiyatlandırma, bölge, CPU ve bellek bilgilerini içeren bir Dağıtım Bilgileri kartı gösterilir. Logs sekmesinde önem derecesine göre filtrelenebilen (Tümü / Hatalar) son günlük girdileri gösterilir. Predict sekmesinde, doğrudan dağıtım üzerinde test yapabileceğin satır içi bir tahmin paneli bulunur; bu panelin Belgeler sonuç sekmesinde, uç nokta URL'si ve çalışma alanı sahipleri için bağlı API anahtarıyla doldurulmuş, kullanıma hazır Python, JavaScript ve cURL kod örnekleri yer alır (bkz. İzleme). Bilgi iletişim kutusunda dağıtımın özellikleri listelenir ve özel meta verileri düzenlemene olanak tanır.

CPU ve Belleği Güncelleme#

1. Hazır durumundaki bir uç noktanın dağıtım sayfasını aç.
2. Yapılandırmayı güncelle seçeneğine tıkla.
3. CPU ve Bellek seçeneklerini belirle, ardından görüntülenen saatlik ücreti incele.
4. Yapılandırmayı Güncelle seçeneğine tıkla. Yeni yapılandırma hazır olana kadar mevcut yapılandırma istekleri karşılamaya devam eder.

Özel kaynaklar çalışma süresi üzerinden ücretlendirilir ve bir örneği etkin tutar; bu, ek ücret olmadan bir IP kameranın çalışmasını da sağlayabilir (Arka Plan Kamerası bölümüne bak). Varsayılan kaynaklara dönmek sıfıra ölçekleme davranışını geri getirir ve arka plan kamerasını kaldırır.

Modeli Değiştirme#

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

1. Dağıtım sayfasını aç
2. Modeli değiştir seçeneğine tıkla
3. Aynı çalışma alanından tamamlanmış başka bir model seç
4. İstersen dağıtım adını düzenle
5. Modeli Değiştir seçeneğine tıkla

Yeni model başlatılırken mevcut model istekleri karşılamaya devam eder. Yeni model hazır olduğunda trafik yeni modele yönlendirilir. Dağıtım kimliği, URL, bölge ve API anahtarı değişmez; görünen ad yalnızca yeni bir ad girersen değişir. Değiştirme başarısız olursa önceki model ve adı etkin kalır.

Değiştirme için aşağıdakilerin tümü gerekir; aksi durumda işlem reddedilir:

• Dağıtım Ready durumunda ve devam eden başka bir yaşam döngüsü işlemi yok
• Yedek modelin ağırlıkları var ve dağıtımla aynı çalışma alanına ait
• Yedek model, zaten dağıtılmış olan model değil

Dağıtım Durumları#

Ready durumundaki bir dağıtımda, uç nokta ilk sağlık kontrolüne yanıt verene kadar sayfadaki rozet Starting yazar; kontrol başarısız olursa Not responding yazar.

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 kopyalama düğmesine tıkla. Uç noktanın kendi API başvurusunu açmak için API documentation seçeneğine tıkla. Uç nokta şu yolları sunar:

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

Uç nokta durumunu yönet:

Uç Noktayı Durdur#

İstekleri kabul etmesini istemediğinde uç noktayı durdur:

1. Dağıtım sayfasında Stop deployment seçeneğine tıkla
2. Uç nokta durumu önce "Stopping", ardından "Stopped" olarak değişir

Durdurulan uç noktalar:

• İstekleri kabul etmez ve canlı ölçüm ya da sağlık durumu bildirmez
• Çalışma süresi ücretlerinin birikmesini durdurur
• Sunum örneği kapandığında geçici izleme istatistikleri ve örnek görseller kaybolur
• URL'lerini, bölgelerini ve bağlı API anahtarlarını korur ve istendiği zaman yeniden başlatılabilir
• Planındaki dağıtım kotasına dahil olmaya devam eder — kotadaki yerini boşaltmak için uç noktayı sil

Uç Noktayı Sil#

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

1. Dağıtım sayfasında More actions (…) seçeneğini açıp Delete Deployment seçeneğine tıkla veya kenar çubuğunda dağıtımın yanındaki çöp kutusu simgesine tıkla
2. Delete ile onayla

Modeli veya projeyi kalıcı olarak sildiğinde ya da çöp kutusundaki model veya proje saklama süresinin sonuna geldiğinde de dağıtımlar kaldırılır.

Uç Noktaları Kullanma#

Kimlik Doğrulama#

Her dağıtım, modele sahip çalışma alanındaki tek bir API anahtarına bağlanır. İsteklere bu anahtarı ekle:

Authorization: Bearer YOUR_API_KEY

Uç nokta yalnızca oluşturulurken bağlanan anahtarı kabul eder; bu nedenle başka hiçbir anahtar uç noktaya erişim sağlamaz — aynı çalışma alanındaki başka bir etkin anahtar bile. Bağlanacak anahtarı belirlemek için çalışma alanı sahibinin anahtarıyla kimlik doğrulaması yaparak API üzerinden dağıtım yap: tam olarak bu anahtar bağlanır ve anahtar zaten elindedir. Başka bir yöntemle (Platform arayüzü veya ekip üyesi olarak kimlik doğrulaması yapılmış bir API çağrısı) oluşturulan dağıtımlarda, sahip olan çalışma alanının etkin anahtarlarından biri otomatik olarak bağlanır — anahtar değerlerini yalnızca çalışma alanı sahibi görüntüleyebildiği için anahtarın değerini çalışma alanı sahibinden iste (bkz. API Anahtarları). Bağlı anahtara sahip olmayan ekip üyeleri yine de tarayıcıdaki Platform tahmin vekil sunucusu üzerinden çıkarım çalıştırabilir.

Uç Noktaya Doğrudan İstekler#

Üretim isteklerini doğrudan dağıtım sayfasında gösterilen URL'ye gönder. Bu istekler Platform API hız sınırlayıcısından geçmediği için dakikada 20 istek tahmin sınırı uygulanmaz. Ancak uç noktanın 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
• Hızlıca yanıtlanamayan istekler 429 ve Retry-After başlığıyla döndürülür
• Tek bir istek en fazla 1 saat çalışabilir; bu süre video çıkarımının tamamlanmasına olanak tanır
• İstek gövdeleri 32 MB ile sınırlıdır; daha büyük yüklemeler 413 ile reddedilir
• 1 KB'tan büyük yanıtlar gzip ile sıkıştırılır ve çapraz kaynaklı tarayıcı isteklerine izin verilir

İstek Örneği#

import requests

# Dağıtım uç noktası
url = "https://YOUR_DEPLOYMENT_URL.run.app/predict"

# Dağıtım API anahtarını içeren başlıklar
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Çıkarım parametreleri
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# Çıkarım için görsel gönder
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

İstek Parametreleri#

Uç nokta, son dağıtımdaki çıkarım çalışma zamanını kullanır. Bu nedenle eğitim boyutu imgsz varsayılanı veya yukarıdaki vid_stride gibi daha yeni davranışlar, örneğin modelini değiştirdiğinde ya da CPU veya bellek ayarını değiştirdiğinde, yeni bir sürüm dağıtıldığında uç noktaya ulaşır. Sabit bir girdi boyutu için imgsz değerini açıkça belirt.

bits değerinin döndürülen derinlik haritasını nasıl değiştirdiğini ve haritanın nasıl çözümleneceğini öğrenmek için Derinlik yanıtları bölümüne bak.

Yanıt Biçimi#

Göreve özgü alanlarla birlikte paylaşılan çıkarımla aynıdır.

Sık Sorulan Sorular#