Link to this sectionAPI Anahtarları#

Ultralytics Platform API anahtarları, uzaktan eğitim, çıkarım ve otomasyon için güvenli programatik erişim sağlar. Farklı kullanım durumları için AES-256-GCM şifrelemeli, isimlendirilmiş anahtarlar oluştur.

Link to this sectionAPI Anahtarı Oluştur#

Yeni bir API anahtarı oluştur:

1. Ayarlar > API Anahtarları kısmına git
2. Anahtar Oluştur düğmesine tıkla
3. Anahtar için bir ad gir (örneğin: "Eğitim Sunucusu")
4. Anahtar Oluştur düğmesine tıkla

Link to this sectionAnahtar Adı#

Anahtarına açıklayıcı bir ad ver:

• training-server - Uzaktan eğitim makineleri için
• ci-pipeline - CI/CD entegrasyonu için
• local-dev - Yerel geliştirme için

Link to this sectionAnahtar Görüntüleme#

Oluşturulduktan sonra anahtar yalnızca bir kez görüntülenir:

Link to this sectionAnahtar Formatı#

API anahtarları şu formatı izler:

• Önek: ul_ ifadesi Ultralytics anahtarlarını tanımlar
• Gövde: 40 rastgele onaltılık (hexadecimal) karakter
• Toplam: 43 karakter

Link to this sectionAnahtar Güvenliği#

• Anahtarlar AES-256-GCM şifrelemesi ile saklanır
• Kimlik doğrulama, hızlı önek araması ve hash karşılaştırması için SHA-256 hash kullanır
• Anahtarın tam değerleri hiçbir zaman düz metin (plaintext) olarak saklanmaz

Link to this sectionAPI Anahtarlarını Kullanma#

Link to this sectionOrtam Değişkeni#

Anahtarını bir ortam değişkeni olarak ayarla:

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

Link to this sectionYOLO CLI#

Anahtarı YOLO CLI kullanarak ayarla:

yolo settings api_key="YOUR_API_KEY"

Link to this sectionKod İçinde#

Anahtarı Python betiklerinde kullan:

import os

# From environment (recommended)
api_key = os.environ.get("ULTRALYTICS_API_KEY")

# Or directly (not recommended for production)
api_key = "YOUR_API_KEY"

Link to this sectionHTTP Başlıkları#

Anahtarı API isteklerine dahil et:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/...

Tüm mevcut uç noktalar için REST API Başvurusu bölümüne bak.

Link to this sectionUzaktan Eğitim#

Anahtarınla metrik akışını etkinleştir.

pip install "ultralytics>=8.4.60"

export ULTRALYTICS_API_KEY="YOUR_API_KEY"
yolo train model=yolo26n.pt data=coco.yaml project=username/project name=exp1

Eksiksiz uzaktan eğitim kılavuzu için Bulut Eğitimi bölümüne bak.

Link to this sectionAnahtarları Yönet#

Link to this sectionAnahtarları Görüntüle#

All keys are listed on the Settings > API Keys tab:

Her anahtar kartı, anahtar adını, şifresi çözülmüş tam anahtar değerini (kopyalanabilir), göreceli oluşturulma zamanını ve bir iptal düğmesini gösterir.

Link to this sectionAnahtarı İptal Et#

Güvenliği ihlal edilmiş veya artık ihtiyaç duyulmayan bir anahtarı iptal et:

1. API Anahtarları bölümünde anahtarı bul
2. İptal (çöp kutusu) düğmesine tıkla
3. İptali onayla

Link to this sectionAnahtarı Yeniden Oluştur#

Bir anahtarın güvenliği ihlal edilirse:

1. Aynı isimle yeni bir anahtar oluştur
2. Uygulamalarını güncelle
3. Eski anahtarı iptal et

Link to this sectionÇalışma Alanı API Anahtarları#

API anahtarları, o anda etkin olan çalışma alanıyla sınırlıdır:

• Kişisel çalışma alanı: Anahtarlar kişisel hesabın olarak kimlik doğrulaması yapar
• Ekip çalışma alanı: Anahtarlar ekip bağlamında kimlik doğrulaması yapar

Kenar çubuğunda çalışma alanları arasında geçiş yaparken, API Anahtarları bölümü o çalışma alanına ait anahtarları gösterir. Çalışma alanı API anahtarlarını yönetmek için Editör rolü veya üzeri gereklidir. Rol detayları için Ekipler bölümüne bak.

Link to this sectionGüvenlik En İyi Uygulamaları#

Link to this sectionYapılacaklar#

• Anahtarları ortam değişkenlerinde sakla
• Farklı ortamlar için ayrı anahtarlar kullan
• Kullanılmayan anahtarları derhal iptal et
• Anahtarları periyodik olarak döndür
• Anahtar amaçlarını tanımlamak için açıklayıcı isimler kullan

Link to this sectionYapılmayacaklar#

• Anahtarları sürüm kontrolüne kaydetme (commit etme)
• Anahtarları uygulamalar arasında paylaşma
• Anahtarları uygulama çıktılarına (log) yazma
• Anahtarları istemci tarafı (client-side) koduna gömme

Link to this sectionAnahtar Döndürme#

Güvenlik için anahtarları periyodik olarak döndür:

1. Aynı isimle yeni anahtar oluştur
2. Uygulamaları yeni anahtarı kullanacak şekilde güncelle
3. Uygulamaların doğru çalıştığını doğrula
4. Eski anahtarı iptal et

Link to this sectionSorun Giderme#

Link to this sectionGeçersiz Anahtar Hatası#

Çözümler:

1. Anahtarın doğru kopyalandığını doğrula (ul_ öneki dahil)
2. Anahtarın iptal edilmediğinden emin ol
3. Ortam değişkeninin ayarlandığını onayla
4. ultralytics>=8.4.60 kullandığından emin ol

Link to this sectionErişim Reddedildi#

Çözümler:

1. Kaynak sahibi olduğunu veya uygun çalışma alanı erişimine sahip olduğunu doğrula
2. Anahtarın doğru çalışma alanına ait olup olmadığını kontrol et
3. Gerekirse yeni bir anahtar oluştur

Link to this sectionHız Sınırı Aşıldı#

Çözümler:

1. İstek sıklığını azalt — uç nokta başına limitler için hız sınırı tablosuna bak
2. Retry-After başlığını kullanarak üstel geri çekilme (exponential backoff) uygula
3. Sınırsız çıkarım hacmi için özel bir uç nokta kullan

Link to this sectionSSS#

Link to this sectionKaç tane anahtar oluşturabilirim?#

API anahtarları üzerinde kesin bir limit yoktur. Farklı uygulamalar ve ortamlar için ihtiyaç duyduğun kadar oluştur.

Link to this sectionAnahtarların süresi dolar mı?#

Anahtarlar otomatik olarak süresi dolmaz. İptal edilene kadar geçerli kalırlar. Güvenlik için anahtar yenilemeyi uygulamayı düşün.

Link to this sectionAnahtarımı oluşturduktan sonra görebilir miyim?#

Evet, tam anahtar değerleri Settings > API Keys altındaki anahtar listesinde görünür durumdadır. Platform, anahtarlarını dilediğin zaman kopyalayabilmen için şifresini çözer ve görüntüler.

Link to this sectionAnahtarlar bölgeye özel mi?#

Anahtarlar bölgeler arası çalışır ancak yalnızca hesabının bulunduğu bölgedeki verilere erişim sağlar.

Link to this sectionAnahtarları ekip üyeleriyle paylaşabilir miyim?#

Daha iyi bir uygulama: Her ekip üyesinin kendi anahtarını oluşturmasını sağla. Ekip çalışma alanları için, Editör rolüne veya daha yüksek bir role sahip her üye, o çalışma alanına özel anahtarlar oluşturabilir.