YOLO Vision 2026:

API 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 adlandırılmış anahtarlar oluştur.

Ultralytics Platform Settings API Keys Tab Key List

API 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 (ör. "Eğitim Sunucusu")
  4. Anahtar Oluştur düğmesine tıkla

Ultralytics Platform Settings API Keys Tab Create API Key Dialog

Anahtar 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

Anahtar Görüntüleme#

Oluşturulduktan sonra anahtar bir onay iletişim kutusunda görüntülenir:

Ultralytics Platform Settings API Keys Tab API Key Created Copy Dialog

Anahtarını Kopyala

Kolayca başvurabilmek için anahtarını oluşturduktan sonra kopyala. Anahtarlar ayrıca anahtar listesinde görünür — platform, anahtar değerlerinin tamamının şifresini çözer ve bunları istediğin zaman kopyalayabilmen için görüntüler.

Anahtar Formatı#

API anahtarları şu formatı izler:

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

Anahtar Güvenliği#

  • Anahtarlar AES-256-GCM şifrelemesi ile saklanır
  • Kimlik doğrulama, hızlı bir indeksli arama için SHA-256 karma (hash) değeri kullanır
  • Tam anahtar değerleri asla düz metin olarak saklanmaz

API Anahtarlarını Kullanma#

Ortam Değişkeni#

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

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

YOLO CLI#

Anahtarı YOLO CLI kullanarak doğrula ve kaydet:

yolo login YOUR_API_KEY

Kaydedilen anahtarı yolo logout ile kaldır.

HTTP Üstbilgileri#

API isteklerine anahtarı dahil et:

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

Tüm mevcut uç noktalar için REST API Referansına bak.

Uzaktan Eğitim#

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

Başlamadan önce ultralytics paketini kur veya güncelle:

pip install -U ultralytics
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.

Anahtarları Yönet#

Anahtarları Görüntüle#

Tüm anahtarlar Settings > API Keys sekmesinde listelenir:

Her anahtar kartı; anahtar adını, kopyalanabilir anahtar değerini, göreli oluşturulma zamanını, kullanım sayısını ve bir iptal etme düğmesini gösterir.

Anahtarı İptal Et#

Güvenliği tehlikeye girmiş 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
Anında Etki

İptal işlemi anında gerçekleşir. Anahtarı kullanan tüm uygulamalar çalışmayı durdurur.

Anahtarı Yeniden Oluştur#

Bir anahtarın güvenliği tehlikeye girerse:

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

Çalışma Alanı API Anahtarları#

API anahtarları, halihazırda etkin olan çalışma alanına göre kapsamlandırılır:

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

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 Düzenleyici rolü veya üstü gereklidir. Rol ayrıntıları için Ekipler bölümüne bak.

Güvenlik En İyi Uygulamaları#

Yapı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ı adlar kullan

Yapılmayacaklar#

  • Anahtarları sürüm kontrolüne kaydetme (commit etme)
  • Anahtarları uygulamalar arasında paylaşma
  • Anahtarları uygulama çıktısında günlüğe kaydetme
  • Anahtarları istemci tarafı koduna gömme

Anahtar Döndürme#

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

  1. Aynı isimle yeni anahtar oluştur
  2. Yeni anahtarı kullanmak için uygulamaları güncelle
  3. Uygulamaların doğru çalıştığını doğrula
  4. Eski anahtarı iptal et
Döndürme Zamanlaması

Hassas uygulamalar için anahtarları her 90 günde bir döndürmeyi düşün.

Sorun Giderme#

Geçersiz Anahtar Hatası#

Error: Invalid API key

Çözümler:

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

Erişim Reddedildi#

Error: Permission denied for this operation

Çö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

Hız Sınırına Takıldı (Rate Limited)#

Error: Rate limit exceeded

Çö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 üstbilgisini kullanarak üstel geri çekilme (exponential backoff) uygula
  3. İzole çıkarım kapasitesine ihtiyaç duyduğunda özel bir uç nokta kullan

SSS#

Kaç tane anahtar oluşturabilirim?#

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

Anahtarların süresi dolar mı?#

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

Oluşturduktan sonra anahtarımı görebilir miyim?#

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

Anahtarlar bölgeye özgü mü?#

Anahtarlar bölgeler arası çalışır ancak yalnızca hesabının bölgesindeki verilere erişir.

Anahtarlarımı ekip arkadaşlarımla paylaşabilir miyim?#

Daha iyi bir uygulama: Her ekip üyesinin kendi anahtarını oluşturmasını sağla. Ekip çalışma alanları için, Düzenleyici veya daha yüksek bir role sahip her üye, o çalışma alanıyla sınırlandırılmış anahtarlar oluşturabilir.

Katkıda Bulunanlar
GLglenn-jocher12SEsergiuwaxmann2LAlaodouya1MYmykolaxboiko1LALaughing-q1

Yorumlar