Özel Uç Noktalar

Ultralytics Platform, YOLO modellerinin 43 küresel bölgedeki özel uç noktalara dağıtılmasını sağlar. Her uç nokta; sıfıra ölçekleme davranışına, benzersiz bir uç nokta URL'sine ve bağımsız izlemeye sahip tek kiracılı bir hizmettir.

Uç Nokta Oluştur

Dağıtım (Deploy) Sekmesinden

Bir modeli Deploy sekmesinden dağıt:

1. Modeline git
2. Deploy sekmesine tıkla
3. Etkileşimli dünya haritasından bir bölge seç — bölgeler konumuna göre gecikme süresine göre renk kodludur (yeşil < 100ms, sarı < 200ms, kırmızı > 200ms)
4. Bölge satırındaki Deploy düğmesine tıkla

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

Dağıtımlar (Deployments) Sayfasından

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

1. New Deployment düğmesine 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 düğmesine 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

Bölge Seçimi

Dünya çapında 43 bölge arasından seçim yap. Etkileşimli bölge haritası ve tablo şunları gösterir:

• Bölge iğneleri: Gecikmeye göre renk kodludur (yeşil < 100ms, sarı < 200ms, kırmızı > 200ms)
• Dağıtılmış bölgeler: "Deployed" rozeti ile vurgulanmıştır
• Dağıtılan bölgeler: Animasyonlu nabız göstergesi
• Çift yönlü vurgulama: Harita üzerinde gezinme tablo satırını vurgular ve tam tersi

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

Kullanılabilir Bölgeler

Uç Nokta Yapılandırması

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

The New Deployment dialog provides:

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

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

When deploying from the model's Deploy tab, endpoints are created with default resources (1 CPU, 2 GB memory) with scale-to-zero enabled. The deployment name is auto-generated.

Uç Noktaları Yönet

Görünüm Modları

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

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

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

• Başlık: Ad, 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 ile canlı sağlık göstergesi
• Tabs: Logs, Code, and Predict

The Logs tab shows recent log entries with severity filtering (All / Errors). The Code tab shows ready-to-use code examples in Python, JavaScript, and cURL with your actual endpoint URL and API key. The Predict tab provides an inline predict panel for testing directly on the deployment.

Dağıtım Durumları

Uç 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.

Yaş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

Uç Noktayı Durdur

Faturalandırmayı duraklatmak için bir uç noktayı durdur:

1. Dağıtım kartındaki duraklat simgesine tıkla
2. Uç nokta durumu "Durduruluyor" ve ardından "Durduruldu" olarak değişir

Durdurulmuş uç noktalar:

• İstekleri kabul etmez
• Ücret oluşturmaz
• İstediğin zaman yeniden başlatılabilir

Uç Noktayı Sil

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

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

Uç Noktaları Kullanma

Kimlik Doğrulama

Her dağıtım, hesabından alınan bir API anahtarı ile oluşturulur. Bunu isteklere 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 Anahtarları kısmından anahtar oluştur.

Hız Sınırı Yok

Dedicated endpoints, Platform API hız sınırlarına tabi değildir. İstekler doğrudan dedicated servisine gider, bu nedenle işleme kapasitesi yalnızca endpoint'inin CPU, bellek ve ölçeklendirme yapılandırması ile sınırlıdır. Bu, API anahtarı başına 20 istek/dakika ile hız sınırlandırılan paylaşımlı çıkarım yöntemine göre temel bir avantajdı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 birlikte paylaşımlı çıkarım ile aynıdır.

Fiyatlandırma

Temel dedicated endpoints tüm planlarda ücretsizdir. Daha yüksek kaynak yapılandırmaları (daha fazla vCPU, daha fazla bellek, sıcak başlatma) gelecekte kullanıma dayalı fiyatlandırma sunacaktır.

SSS

Kaç tane endpoint oluşturabilirim?

Endpoint limitleri 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, 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 endpoint'i sil
2. İstenen bölgede yeni bir endpoint oluştur

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

Küresel kapsama için:

1. Birden fazla bölgeye dağıtım yap
2. Bir yük dengeleyici veya DNS yönlendirmesi kullan
3. Kullanıcıları en yakın endpoint'e yönlendir

Soğuk başlatma süresi nedir?

Soğuk başlatma süresi, model boyutuna ve konteynerin o 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.

Özel alan adları kullanabilir miyim?

Özel alan adları yakında geliyor. Şu anda endpoint'ler platform tarafından oluşturulan URL'leri kullanmaktadır.