Özel Uç Noktalar

Ultralytics Platformu, YOLO modellerinin 43 küresel bölgedeki özel uç noktalara dağıtımını sağlar. Her uç nokta, otomatik ölçeklendirme, benzersiz bir uç nokta URL'si ve bağımsız izleme özelliklerine sahip tek kiracılı bir hizmettir.

Uç Nokta Oluştur

Dağıtım Sekmesinden

Bir modeli şuradan dağıtın: Deploy sekme:

1. Modelinize gidin
2. Dağıt sekmesine tıklayın
3. Bölge tablosundan bir bölge seçin (konumunuzdan gecikmeye göre sıralanmıştır)
4. Bölge satırında Dağıt'a tıklayın

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

Dağıtımlar Sayfasından

Küresel sayfadan bir dağıtım oluşturun Deploy yan çubukta:

1. Yeni Dağıtım'a tıklayın
2. Model seçiciden bir model seçin
3. Haritadan veya tablodan bir bölge seçin
4. İsteğe bağlı olarak dağıtım adını ve kaynaklarını özelleştirin
5. Modeli Dağıt'a tıklayın

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 genelinde 43 bölgeden birini seçin. Etkileşimli bölge haritası ve tablosu şunları gösterir:

• Region pins: Color-coded by latency (green < 100ms, yellow < 200ms, red > 200ms)
• Dağıtılmış bölgeler: "Dağıtıldı" rozetiyle vurgulanmıştır
• Dağıtılmakta olan bölgeler: Animasyonlu nabız göstergesi
• Çift yönlü vurgulama: Harita üzerinde gezinmek tablo satırını vurgular ve bunun tersi de geçerlidir

Modeldeki bölge tablosu Deploy sekmesi şunları içerir:

Mevcut Bölgeler

Uç Nokta Yapılandırması

Yeni Dağıtım Diyaloğu

New Deployment iletişim kutusu şunları sağlar:

Kaynak ayarları, daraltılabilir Kaynaklar bölümünün altında mevcuttur. Dağıtımlar varsayılan olarak sıfıra ölçeklendirme kullanır (minimum örnek = 0, maksimum örnek = 1) — yalnızca aktif çıkarım süresi için ödeme yaparsınız.

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

Modelin şuradan dağıtım yaparken Deploy sekmesinde, uç noktalar sıfıra ölçeklendirme etkinleştirilmiş varsayılan kaynaklarla (1 CPU, 2 GB bellek) 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ü)

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 belgelerine bağlantı içeren kopyalanabilir URL
• Metrikler: İstek sayısı (24 saat), P95 gecikmesi, hata oranı
• Sağlık kontrolü: Gecikme ve manuel yenileme ile canlı sağlık göstergesi
• Sekmeler: Logs, Codeve Predict

Logs sekmesi, önem derecesi filtrelemesi (Tümü / Hatalar) ile son günlük girişlerini gösterir. Code sekmesi, gerçek uç nokta URL'niz ve API anahtarınızla python, JavaScript ve cURL'de kullanıma hazır kod örneklerini gösterir. Predict sekmesi, dağıtım üzerinde doğrudan test yapmak için satır içi bir tahmin paneli sağlar.

Dağıtım Durumları

Uç Nokta URL'si

Her uç nokta benzersiz bir URL'ye sahiptir, örneğin:

https://predict-abc123.run.app

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

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

Uç nokta durumunuzu kontrol edin:

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ı durdurun:

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

Durdurulmuş uç noktalar:

• İstekleri kabul etmez
• Ücret tahakkuk ettirmez
• İstediğiniz zaman yeniden başlatılabilir

Uç Noktayı Sil

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

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

Uç Noktaları Kullanma

Kimlik Doğrulama

Her dağıtım, hesabınızdan bir API anahtarı ile oluşturulur. İsteklere dahil edin:

Authorization: Bearer YOUR_API_KEY

API anahtarı öneki, tanımlama için dağıtım kartı altbilgisinde görüntülenir. Anahtarları API Anahtarları bölümünden oluşturun.

Hız Sınırı Yok

Özel uç noktalar Platform API hız sınırlarına tabi değildir. İstekler doğrudan özel hizmetinize gider, bu nedenle verim, yalnızca uç noktanızın CPU, bellek ve ölçeklendirme yapılandırmasıyla sınırlıdır. Bu, API anahtarı başına dakikada 20 istekle hız sınırlamasına tabi olan paylaşımlı çıkarıma göre önemli 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())

// Build form data with image and parameters
const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("conf", "0.25");
formData.append("iou", "0.7");
formData.append("imgsz", "640");

// Send image for inference
const response = await fetch(
  "https://predict-abc123.run.app/predict",
  {
    method: "POST",
    headers: { Authorization: "Bearer YOUR_API_KEY" },
    body: formData,
  }
);

const result = await response.json();
console.log(result);

curl -X POST \
  "https://predict-abc123.run.app/predict" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@image.jpg" \
  -F "conf=0.25" \
  -F "iou=0.7" \
  -F "imgsz=640"

İstek Parametreleri

Yanıt Biçimi

Göreve özel alanlarla paylaşılan çıkarım ile aynıdır.

Fiyatlandırma

Özel uç noktalar şunlara göre faturalandırılır:

SSS

Kaç tane uç nokta oluşturabilirim?

Uç nokta limitleri plana bağlıdır:

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

Her model, plan kotanız dahilinde birden fazla bölgeye yine de 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ı silin
2. İstenen bölgede yeni bir uç nokta oluşturun

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

Küresel kapsama için:

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

Soğ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.

Özel alan adları kullanabilir miyim?

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

📅 1 ay önce oluşturuldu ✏️ 5 gün önce güncellendi

Yorumlar