Link to this sectionÖzel Uç Noktalar#

Ultralytics Platform, YOLO modellerini 43 küresel bölgedeki özel uç noktalara dağıtmanı sağlar. Her uç nokta, sıfıra ölçeklenebilirlik, benzersiz bir uç nokta URL'si ve bağımsız izleme özelliklerine sahip tek kiracılı bir hizmettir.

Link to this sectionUç Nokta Oluştur#

Link to this sectionDağıtım Sekmesinden#

Bir modeli Deploy (Dağıt) sekmesinden dağıt:

1. Modeline git
2. Deploy (Dağıt) sekmesine tıkla
3. İnteraktif dünya haritasından bir bölge seç — bölgeler, bulunduğun konumdan itibaren gecikme süresine göre yeşilden kırmızıya bir gradyan ile renk kodludur (daha hızlı bölgeler yeşil, daha yavaş bölgeler kırmızıdır)
4. Bölge satırındaki Deploy (Dağıt) butonuna tıkla

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

Link to this sectionDağıtımlar Sayfasından#

Kenar çubuğundaki genel Deploy (Dağıt) 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. Otomatik oluşturulan dağıtım adını (düzenlenebilir) ve varsayılan kaynakları gözden geçir
5. Deploy Model (Modeli Dağıt) öğesine tıkla

Link to this sectionDağı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

Link to this sectionBölge Seçimi#

Dünya çapında 43 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:

Link to this sectionMevcut Bölgeler#

Link to this sectionUç Nokta Yapılandırması#

Link to this sectionYeni Dağıtım Diyaloğu#

New Deployment (Yeni Dağıtım) iletişim kutusu şunları sağlar:

Dağıtımlar, 1 CPU, 2 GiB bellek, minInstances = 0 ve maxInstances = 1 gibi sabit varsayılan değerleri kullanır. Boştayken sıfıra ölçeklenirler, böylece yalnızca aktif çıkarım süresi için ödeme yaparsın.

Link to this sectionDağıtım Sekmesi (Hızlı Dağıtım)#

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

Link to this sectionUç Noktaları Yönet#

Link to this sectionGörünüm Modları#

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

Link to this sectionDağı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 (Günlükler), Code (Kod) ve Predict (Tahmin)

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

Link to this sectionDağıtım Durumları#

Link to this sectionUç Nokta URL'si#

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

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

Link to this sectionYaşam Döngüsü Yönetimi#

Uç nokta durumunu kontrol et:

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

    style R fill:#4CAF50,color:#fff
    style S fill:#9E9E9E,color:#fff
    style D fill:#F44336,color:#fff

Link to this sectionUç Noktayı Durdur#

Faturalandırmayı duraklatmak iç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
• Ücret yansıtmaz
• İstenildiği zaman yeniden başlatılabilir

Link to this sectionUç 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

Link to this sectionUç Noktaları Kullanma#

Link to this sectionKimlik 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ı alt bilgisinde görüntülenir. API Keys kısmından anahtar oluştur.

Link to this sectionHız Sınırı Yok#

Doğrudan özel uç noktanın URL'sine gönderilen istekler Platform API hız sınırlarına tabi değildir — iş hacmi yalnızca uç noktanın CPU, bellek ve ölçeklendirme yapılandırması ile sınırlıdır. (Platform API üzerinden proxy'lenen istekler, örneğin tarayıcı içi test aracı, standart 20 istek/dakika tahmin sınırını kullanmaya devam eder.) Bu, API anahtarı başına 20 istek/dakika ile hız sınırlı olan paylaşımlı çıkarım karşısında önemli bir avantajdır.

Link to this sectionİ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())

Link to this sectionİstek Parametreleri#

Link to this sectionYanıt Formatı#

Göreve özgü alanlarla birlikte paylaşımlı çıkarım ile aynıdır.

Link to this sectionFiyatlandırma#

Temel özel uç noktalar tüm planlarda ücretsizdir. Daha yüksek kaynaklı yapılandırmalar (daha fazla vCPU, daha fazla bellek, sıcak başlatma) gelecekte kullanıma dayalı fiyatlandırma sunacaktır.

Link to this sectionSSS#

Link to this sectionKaç 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.

Link to this sectionDağı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

Link to this sectionÇ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

Link to this sectionSoğuk başlatma süresi nedir?#

Soğuk başlatma süresi, model boyutuna ve kapsayıcının bölgede önbelleğe alınıp alınmadığına bağlıdır. Tipik aralıklar:

Sağlık kontrolü, en kötü durumdaki soğuk başlatmaları karşılamak için 55 saniyelik bir zaman aşımı kullanır.

Link to this sectionÖzel alan adları kullanabilir miyim?#

Özel alan adları yakında geliyor. Şu anda uç noktalar platform tarafından oluşturulan URL'leri kullanıyor.