Ultralytics Platform Hızlı Başlangıç#
Ultralytics Platform, veri setleri yüklemek, önceden eğitilmiş ağırlıklardan yeni YOLO modelleri eğitmek, tarayıcıda tamamlanan modelleri test etmek ve özel çıkarım uç noktaları yapılandırmak için rehberli bir iş akışı sağlar.
Watch: Get Started with Ultralytics Platform - QuickStart
Aşağıdaki etkileşimli diyagram, Ultralytics Platform iş akışının dört ana aşamasını özetlemektedir. İlgili bölüm için ayrıntılı talimatlara erişmek üzere herhangi bir aşamaya veya alt adıma tıkla.
graph LR
A(Sign Up):::start --> B(Prepare Data):::proc --> C(Train):::proc --> D(Deploy):::out
A -.- A1["<a href='#get-started'>Create account</a><br/><a href='#region-selection'>Select region</a>"]:::proc
B -.- B1["<a href='#upload-your-first-dataset'>Upload dataset</a><br/><a href='#create-your-first-project'>Create Project</a>"]:::proc
C -.- C1["<a href='#training-configuration'>Configure training</a><br/><a href='#monitor-training'>Monitor progress</a>"]:::proc
D -.- D1["<a href='#test-your-model'>Test model</a><br/><a href='#deploy-to-production'>Deploy endpoint</a>"]:::proc
click A "#get-started"
click B "#upload-your-first-dataset"
click C "#train-your-first-model"
click D "#deploy-to-production"
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef out fill:#9C27B0,color:#fffBaşlarken#
Ultralytics Platform çeşitli kolay kaydolma seçenekleri sunar. Google veya GitHub hesaplarını kullanarak ya da e-posta adresinle kayıt olup giriş yapabilirsin.

Bölge Seçimi#
İlk kurulum sırasında veri bölgenizi seçmeniz istenecektir. Platform, her bölgeye olan gecikmeyi otomatik olarak ölçer ve en yakın olanı önerir. Bu seçim; veri setlerinizin, modellerinizin ve yönetilen eğitim verilerinizin nerede saklanacağını belirler. Adanmış uç nokta bölgeleri, bir model dağıttığınızda ayrı olarak seçilir.

| Bölge | Etiket | Konum | En İyi Kullanım |
|---|---|---|---|
| US | Amerika | Iowa, ABD | Amerika kullanıcıları, Amerika için en hızlısı |
| EU | Avrupa, Orta Doğu ve Afrika | Belçika, Avrupa | Avrupalı kullanıcılar, GDPR uyumluluğu |
| AP | Asya Pasifik | Tayvan, Asya-Pasifik | Asya-Pasifik kullanıcıları, en düşük APAC gecikme süresi |
Veri bölgen kullanıma alım sırasında ayarlanır ve sonrasında kendin değiştiremezsin, bu nedenle en iyi performans için sana veya kullanıcılarına en yakın bölgeyi seç. Daha sonra bölge değiştirmen gerekirse, bir değişiklik talebinde bulunmak için destek ekibiyle iletişime geç.
Ücretsiz Krediler#
Her yeni hesap, bulut GPU eğitimi için ücretsiz krediler alır:
| E-posta Türü | Kayıt Kredisi | Nasıl Hak Kazanılır |
|---|---|---|
| İş/Şirket E-postası | $25.00 | Şirket alan adını kullan (@sirket.com) |
| Kişisel E-posta | $5.00 | Gmail, Yahoo, Outlook vb. |
$25 değerinde kredi almak için bir iş e-postası ile kaydol. Kişisel bir e-posta ile kaydolduysan, ek $20 kredinin kilidini açmak için daha sonra bir iş e-postasını doğrulayabilirsin.
Profilini Tamamla#
Kullanıma alım akışı seni üç adımda yönlendirir:
- Profil - Görünen adını, benzersiz kullanıcı adını (kalıcıdır, daha sonra değiştirilemez), kurumunu (isteğe bağlı) ve birincil kullanım amacını gir
- Veri Bölgesi - Gecikme süresini gösteren görsel bir dünya haritası ile US, EU veya AP seç
- Tamamla - Seçimlerini gözden geçir, isteğe bağlı olarak bir promosyon kodu uygula ve hoş geldin kredilerini almak için kaydı bitir

Daha Sonra Güncelle
Profilini, Settings bölümünden görünen adın, biyografin ve sosyal bağlantıların dahil olmak üzere istendiğinde güncelleyebilirsin. Kullanıcı adın kayıttan sonra değiştirilemez. Veri bölgesi için kendi kendine yapabileceğin bir değişiklik yoktur; bir taşıma talebinde bulunmak için destek ekibiyle iletişime geç.
Ana Panel#
Oturum açtıktan sonra, çalışma alanı istatistiklerini içeren bir hoş geldin kartı, bir tanıtım videosu, veri setlerine, projelere ve depolamaya hızlı erişim ve son etkinlik akışını sunan Ultralytics Platform Ana sayfasına yönlendirileceksin.

Kenar Çubuğu Gezinmesi#
Kenar çubuğu, tüm Platform bölümlerine erişim sağlar:
| Bölüm | Öğe | Açıklama |
|---|---|---|
| Üst | Arama | Tüm kaynaklarında hızlı arama (Cmd+K) |
| Ana Sayfa | Hızlı eylemler ve son etkinliklerle dolu panel | |
| Keşfet | Genel projeleri ve veri setlerini keşfet | |
| İçerik | Etiketle | Veri setlerin, bir tane oluşturmak için + kısayoluyla birlikte |
| Eğit (Train) | Eğitilmiş modellerini içeren projelerin | |
| Dağıt | Aktif dağıtımların; herhangi bir girdi, dağıtım panosunu açar | |
| Alt Bilgi | Yardım | Kılavuzlar, topluluk bağlantıları ve uygulama içi geri bildirim formu |
| Ayarlar | Hesap, faturalandırma, ekipler ve tercihler | |
| Hesap | Çalışma alanı değiştirici, etkinlik ve Oturumu kapat seçeneklerini içeren profil menüsü |
Her içerik bölümü, geri kalanına giden bir bağlantıyla birlikte en son beş öğeni listeler. Bir öğenin üzerine gelmek, onu Çöp Kutusu'ne taşıyan bir silme eylemini ortaya çıkarır; Çöp Kutusu'nun kendisine arama (Cmd+K) üzerinden veya platform.ultralytics.com/trash açılarak erişilir.
Hesap olmadan aynı kenar çubuğu, kendi içeriğin yerine @ultralytics adresinden halka açık Veri Setleri ve Modeller'i gösterir ve alt bilgi, hesap menüsü yerine bir kaydolma kartı gösterir.
Hoş Geldin Kartı#
Hoş geldin kartı bir bakışta profilini, plan rozetini (plan karşılaştırmasına bağlanır) ve çalışma alanı istatistiklerini gösterir. Her istatistik, eşleşen çalışma alanı görünümüne bağlanır:
| İstatistik | Açıklama |
|---|---|
| Veri Kümeleri | Veri seti sayısı |
| Görüntüler | Tüm veri setlerindeki toplam görüntü sayısı |
| Etiketler | Toplam etiket sayısı |
| Projeler | Proje sayısı |
| Modeller | Toplam eğitilmiş model |
| Dışa Aktarımlar | Model dışa aktarım sayısı |
| Dağıtımlar | Aktif dağıtım sayısı |
Hızlı Eylemler#
Hoş geldin kartının altında, panel üç kart gösterir:
- Veri Setleri: Yeni bir veri seti oluştur veya yüklemek için görüntü, video veya veri seti dosyalarını sürükle. Son veri setlerini gösterir.
- Projects: Yeni bir proje oluştur veya yüklemek için
.ptmodel dosyalarını bırak. Son projelerini gösterir. - Depolama: Plan limitlerinle birlikte depolama kullanımına (veri setleri, modeller, dışa aktarımlar) genel bakış.
Alt kısımda yer alan bir Son Etkinlik tablosu, en son veri setlerini, projelerini ve dağıtımlarını durumları ve son güncelleme zamanlarıyla birlikte gösterir.
Küresel Arama#
Arama çubuğunu açmak için Cmd+K (Mac) veya Ctrl+K (Windows/Linux) tuşlarına bas. Sayfalar, projeler, veri setleri ve dağıtımlar arasında anında arama yap.
Yapay Zeka Sohbet Asistanı#
Her sayfada yüzen bir sohbet widget'ı mevcuttur. YOLO eğitimi, etiketleme, dağıtım veya herhangi bir Platform özelliği hakkında soru sormak için tıkla. Asistan, mevcut sayfaya dayalı bağlamsal yardım sağlar.
Kullanıma Alım Turları#
Platform, farklı bölümleri keşfederken temel özellikleri tanıtan rehberli turlar içerir:
| Tur | Tetikleyici | Neleri Kapsar |
|---|---|---|
| Gezinti Turu | Eğitim sürecinden sonra Ana Sayfaya ilk ziyaret | Ana Sayfa, Keşfet, Etiketle, Eğit, Dağıt, Ayarlar, Hesabın |
| Proje Turu | Bir proje sayfasına ilk ziyaret | Modeller, Eğitim Grafikleri, Model Eğit |
| Veri Kümesi Turu | Bir veri kümesi sayfasına ilk ziyaret | Görseller, Veri Seti Bölümleri, Sınıflar, Grafikler, Model Eğit, Görsel Yükle, Veri Seti İndir |
Kurumsal plan kullanıcıları, Eğit adımına ilişkin kurumsal rehberlik içeren geliştirilmiş bir Gezinti Turu görürler.
Turları Yeniden Başlat#
Herhangi bir turu yeniden oynatmak için:
- Turu Yeniden Başlat düğmesi — Hesap menüsünü açmak için profil avatarına (kenar çubuğunun sol alt kısmı) tıkla, ardından Turu Yeniden Başlat'ı seç. Bu, her bölüme bir sonraki deyişinde turlar yeniden oynatılsın diye tüm turları sıfırlar.
- URL parametresi — Doğrudan birini yeniden başlatmak için
?tour=değerini tur kimliğiyle birlikte ekle: Ana sayfada?tour=nav, proje sayfasında?tour=projectveya veri seti sayfasında?tour=dataset.
İlk Veri Kümeni Yükle#
Kenar çubuğunda Annotate aç ve yeni bir veri seti oluşturmak için + üzerine tıkla. Ayrıca dosyaları doğrudan Ana sayfa panosundaki Veri Setleri kartının üzerine sürükleyip bırakabilirsin.
Yeni Veri Seti iletişim kutusu dört kaynak sunar. Bu hızlı başlangıç kılavuzu Yükle seçeneğini kullanır; diğerleri Veri Setleri ve Entegrasyonlar bölümünde ele alınmıştır:
| Kaynak | Kullanılabilirlik | Açıklama |
|---|---|---|
| Yükleme | Tüm planlar | Bilgisayarından görselleri, videoları, arşivleri veya NDJSON dosyalarını bırak |
| URL | Tüm planlar | Bir ZIP, TAR, TAR.GZ, TGZ veya NDJSON dosyasına doğrudan HTTP ya da HTTPS bağlantısından içe aktar |
| Bulut | Pro ve üzeri | Bir S3, GCS veya Azure paketini (bucket) bağla |
| Şirket İçi (On-Premise) | Enterprise | Kendi bağlı sunucunda kalan verileri indeksle |
Yüklemeler birden çok formatı destekler (tam ayrıntılar Veri Setleri bölümündedir):
| Format | Maksimum Boyut (Ücretsiz / Pro / Kurumsal) | Açıklama |
|---|---|---|
| Görüntüler | 50 MB | JPG, PNG, WebP, TIFF ve diğer yaygın formatlar |
| Veri Kümesi Arşivi | 10 / 20 / 50 GB | Görseller ve etiketler içeren ZIP veya TAR arşivi (.tar.gz ve .tgz dahil) |
| Video | 1 GB | MP4, WebM, MOV, MKV, M4V - 1 FPS hızında çıkarılan kareler (maksimum 100 kare) |
| NDJSON | 10 / 20 / 50 GB | Taşınabilir meta veriler için Ultralytics veri kümesi dışa aktarma formatı |
graph LR
A[Drop Files]:::start --> B[Auto-Package ZIP]:::proc
B --> C[Upload to Storage]:::proc
C --> D[Process Data]:::proc
D --> E[Resize & Thumbnail]:::proc
E --> F[Parse Labels]:::proc
F --> G[Compute Statistics]:::proc
G --> H[Dataset Ready]:::out
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef out fill:#9C27B0,color:#fffYüklemeden sonra platform verilerini otomatik olarak işler:
- 4096 pikselden büyük görüntüler yeniden boyutlandırılır (en boy oranı korunarak)
- Hızlı göz atma için 256 piksellik küçük resimler oluşturulur
- YOLO, COCO ve Ultralytics NDJSON etiketleri ayrıştırılır ve doğrulanır
- İstatistikler hesaplanır (sınıf dağılımı, ısı haritaları, boyutlar)
En iyi sonuçlar için, standart YOLO yapısına sahip, görseller ve etiketler içeren bir ZIP veya TAR arşivi (.tar.gz ve .tgz dahil) yükle:
my-dataset.zip
├── data.yaml # Class names and splits
├── train/
│ ├── images/
│ │ ├── img001.jpg
│ │ └── img002.jpg
│ └── labels/
│ ├── img001.txt
│ └── img002.txt
└── val/
├── images/
└── labels/Tüm görevlerdeki tam sözdizimi için detect, segment, pose, OBB ve classify veri seti kılavuzlarına göz at.
datasets hakkında daha fazla bilgi edin ve detect, segment, pose, OBB ve classify için desteklenen formatları incele.
İlk Projeni Oluştur#
Projeler, ilgili modelleri ve deneyleri organize etmene yardımcı olur. Kenar çubuğunda Train aç ve proje oluşturmak için + üzerine tıkla. Ayrıca bir proje oluşturmak ve bunları tek adımda içe aktarmak için Ana sayfa panosundaki Projeler kartının üzerine .pt ağırlıklarını bırakabilirsin.
Bir ad ve isteğe bağlı açıklama gir. Projeler; model çalıştırmalarını, içe aktarılan veya klonlanan model ağırlıklarını ve tamamlanan eğitim sonuçlarını karşılaştırmak için grafiklerle birlikte organize eder.
projects hakkında daha fazla bilgi edin.
İlk Modelini Eğit#
Projenden, Yeni Model Eğit iletişim kutusunu açmak için New Model üzerine tıkla. Ayrıca bir veri seti sayfasından da başlayabilirsin; bu durumda veri seti sabitlenir ve bunun yerine hedef projeyi seçersin.

Eğitim Yapılandırması#
- Temel Model: Resmi Ultralytics ağırlıklarını veya kendi eğittiğin modellerden birini seç. Model görevi ile veri seti görevi eşleşmiyorsa iletişim kutusu uyarı verir.
- Veri Seti: En az bir eğitim görseli, en az bir doğrulama veya test görseli ve en az bir etiketlenmiş görsel içeren hazır bir veri seti seç
- Parametreler: Epochs (varsayılan 100), Batch Size (boş bırakılması otomatik anlamına gelir), Image Size (varsayılan 640) ve isteğe bağlı bir çalıştırma adı (Name) belirle. Diğer tüm Ultralytics eğitim argümanlarını bir YAML düzenleyicisinde düzenlemek için Gelişmiş Ayarlar'ı genişlet.
- GPU Seç: Bulut Eğitimi sekmesinde, bütçene ve model boyutuna göre işlem gücü seç. Varsayılan seçenek, her YOLO26 varyantını işleyebilen RTX PRO 6000 (96 GB Blackwell, 2,09$/saat) modelidir. Listenin tamamı ve katman kısıtlamaları için GPU fiyatlandırma tablosu veya Bulut Eğitimi GPU adımı sayfasına göz at.
- Eğitimi Başlat: Kredi bakiyenin yanındaki tahmini maliyeti ve süreyi incele, ardından
Start Trainingöğesine tıkla.
Platform barındırmalı bir veri setinin anlık görüntüsünü almak ve çalıştırmaya bağlamak için başlatmadan önce Veri Seti Sürümünü Kaydet seçeneğini işaretle; böylece tam eğitim verisi daha sonra yeniden üretilebilir. Veri Setleri sayfasına göz at.
Bulut eğitimi, tahmini iş maliyetini karşılamaya yetecek pozitif bir kredi bakiyesi gerektirir. Eğitim iletişim kutusundan doğrudan bakiye yükle veya Settings > Billing üzerinden bakiye kontrolü yap. Yeni hesaplara ücretsiz krediler verilir (kişisel e-posta için 5$, iş e-postası için 25$).
Eğitimi İzle#
Eğitim başladığında, üç alt sekme aracılığıyla ilerlemeyi gerçek zamanlı olarak izlemek için modelin Train sekmesini aç:
| Alt sekme | İçerik |
|---|---|
| Grafikler | Eğitim/doğrulama kayıp eğrileri, mAP, hassasiyet, geri çağırma |
| Konsol | Canlı eğitim günlüğü çıktısı |
| Sistem | GPU kullanımı, bellek kullanımı, donanım metrikleri |
Metrikler SSE (Sunucu Tarafından Gönderilen Etkinlikler) aracılığıyla gerçek zamanlı olarak akıtılır. Doğrulama çıktıları mevcut olduğunda, Grafik alt sekmesi Eğitim ve Doğrulama görünümleri olarak ikiye ayrılır; karmaşıklık matrisi, PR eğrileri ve F1 eğrileri Doğrulama altında yer alır.
Çalışan bir eğitim işini istediğin zaman iptal edebilirsin. Sadece o noktaya kadar kullanılan işlem süresi için ücretlendirilirsin.
cloud training hakkında daha fazla bilgi edin.
Modelini Test Et#
Eğitim tamamlandıktan sonra modelini doğrudan tarayıcıda test et:
- Modelinin
Predictsekmesine git - Bir görsel yükle, sürükleyip bırak, web kamerandan bir tane yakala veya örnek bir görsele tıkla (bırakma anında otomatik çıkarım)
- Göreve uygun tahmin katmanlarını, aşama bazında süreleri (ön işlem, çıkarım, son işlem, ağ) ve ham JSON yanıtını görüntüle
Çıkarım parametrelerini ayarla:
| Parametre | Varsayılan | Açıklama |
|---|---|---|
| Güven (Confidence) | 0.25 | Düşük güvenli tahminleri filtrele |
| IoU | 0.7 | NMS için örtüşmeyi kontrol et |
| Görüntü Boyutu | 640 | Çıkarım için girdiyi yeniden boyutlandır |
API Belirtimleri altında, Predict sekmesi yukarıda seçtiğin parametrelerle önceden doldurulmuş Python, JavaScript ve cURL dillerinde örnek kod gösterir. Önce modeli dağıt, ardından yer tutucu URL'yi ve anahtarı uç noktandaki değerlerle değiştir:
import requests
url = "https://your-deployment-url.run.app/predict"
api_key = "YOUR_API_KEY"
args = {"conf": 0.25, "iou": 0.7, "imgsz": 640}
with open("image.jpg", "rb") as f:
response = requests.post(
url,
headers={"Authorization": f"Bearer {api_key}"},
data=args,
files={"file": f},
)
print(response.json())Tahmin sekmesi, bir görsel bıraktığında otomatik olarak çıkarım çalıştırır (bir düğmeye tıklamana gerek yoktur) ve güven düzeyini, IoU değerini veya görsel boyutunu her değiştirdiğinde bunu yeniden çalıştırır. Anında test edilebilmesi için örnek görseller (bus.jpg, zidane.jpg) önceden yüklenmiştir.
inference hakkında daha fazla bilgi edin.
Üretime Dağıt#
Modelini üretimde kullanım için özel bir uç noktaya dağıt:
- Modelinin
Deploysekmesine git - Platform, tüm 42 bölgeye olan gecikmeyi ölçer ve bunları yeşilden kırmızıya bir gradyanla renklendirilmiş (daha düşük gecikme yeşil, daha yüksek gecikme kırmızı) bir dünya haritası üzerinde çizer
- Haritanın altındaki — bulunduğun konuma göre gecikmeye göre sıralanmış — Bölge Gecikmesi tablosunda istediğin bölgeyi bul. İstediğin zaman yeniden ölçüm yapmak için
Rescankullan. - Uç noktanı oluşturmak için o satırdaki
Deployöğesine tıkla

graph LR
A[Select Region]:::start --> B[Deploy]:::proc
B --> C[Provisioning]:::proc
C --> D[Running]:::out
D --> E{Lifecycle}:::decide
E --> F[Stop]:::error
E --> G[Delete]:::error
F --> H[Resume]:::proc
H --> D
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef decide fill:#FF9800,color:#fff
classDef out fill:#9C27B0,color:#fff
classDef error fill:#F44336,color:#fffSağlama tamamlandığında uç noktanız şunları sağlar:
- Benzersiz URL: API çağrıları için HTTPS uç noktası
- Scale-to-zero davranışı: Boştaki uç noktalar sıfıra ölçeklenir (dağıtımlar şu anda tek bir aktif örnek çalıştırır)
- İzleme: İstek metrikleri ve günlükler
Uç noktalar başlatılabilir, durdurulabilir ve silinebilir. Durdurulan uç noktalar yapılandırmalarını korur ve tek bir tıklamayla yeniden başlatılabilir.
Dağıtımdan sonra, kenar çubuğundaki Deploy bölümünden tüm uç noktalarını yönetebilirsin. Dağıtımlar panosu; aktif dağıtımlarınla birlikte küresel bir harita, 24 saatlik metrikler (toplam istekler, aktif dağıtımlar, hata oranı ve P95 gecikmesi) ve her bir uç noktanın listesini gösterir.
endpoints hakkında daha fazla bilgi edin.
Uzaktan Eğitim (İsteğe Bağlı)#
Kendi donanımınızda eğitmeyi tercih ediyorsanız, her yerde eğitmek ve metrikleri Ultralytics Platform'a akıtmak için API anahtarınızı kullanabilirsiniz.
En hızlı yol, eğitim iletişim kutusundaki Yerel Eğitim sekmesidir: seçtiğin model, veri seti ve parametreler için tam komutu oluşturur ve bir API anahtarı doldurur (henüz yoksa bir tane oluşturur). Onu kopyala ve terminalinde çalıştır.
Komutu kendin oluşturmak için:
Settings > API Keysiçinde bir API anahtarı oluştur- Ortam değişkenini ayarla ve
projectiçinusername/projectdeğeriyle birlikte eğit:
export ULTRALYTICS_API_KEY="YOUR_API_KEY"
yolo train model=yolo26n.pt data=coco.yaml epochs=100 project=username/my-project name=exp1Metrik akışına sahip yerel eğitim, ultralytics>=8.4.120 gerektirir. API anahtarları ul_ ile başlar, ardından 40 onaltılık karakter (toplam 43 karakter) gelir ve çalışma alanına kapsamlandırılmış tam erişimli belirteçlerdir.
API keys, dataset URIs ve remote training hakkında daha fazla bilgi edin.
Geri Bildirim & Yardım#
Kenar çubuğu alt bilgisindeki Yardım sayfası; dokümantasyon bağlantılarını, video anlatımlarını ve topluluk kaynaklarını bir araya getirir ve uygulama içi bir geri bildirim formu içerir. Deneyimini 1 ile 5 yıldız arasında değerlendirebilir, bir geri bildirim türü (Hata, Özellik veya Genel) seçebilir ve bir ekran görüntüsü ekleyebilirsin.
Daha fazla yardıma ihtiyacın olursa:
- AI Chat: Anında yardım almak için herhangi bir sayfadaki yüzen sohbet penceresine tıkla
- Documentation: datasets, annotation, training, deployment ve billing hakkında ayrıntılı kılavuzlar için bu belgelere göz at
- Discord: Tartışmalar için Discord community topluluğumuza katıl
- GitHub: Sorunları GitHub üzerinde bildir
- REST API ve Python SDK: Tüm Platform özelliklerine programlı erişim için API referansına göz at,
ultralytics-platformistemcisini yükle veya etkileşimli API belgelerini dene