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 adlandırılmış 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 (ör. "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 bir kez görüntülenir:

Link to this sectionAnahtar Formatı#

API anahtarları şu formatı izler:

• Önek: ul_ 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ı bir indeksli arama için SHA-256 karma (hash) değeri kullanır
• Tam anahtar değerleri asla düz metin 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 Ü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.

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ı, tam şifresi çözülmüş anahtar değerini (kopyalanabilir), göreceli oluşturma zamanını ve bir iptal düğmesini gösterir.

Link to this sectionAnahtarı İ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

Link to this sectionAnahtarı 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

Link to this sectionÇ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.

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

Link to this sectionYapı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

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. Yeni anahtarı kullanmak için uygulamaları 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ğini kontrol et
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ına Takıldı (Rate Limited)#

Çö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. Sınırsız çıkarım iş 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 sınır yoktur. Farklı uygulamalar ve ortamlar için ihtiyaç duyduğun kadar oluştur.

Link to this sectionAnahtarları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.

Link to this sectionOluşturduktan sonra anahtarımı görebilir miyim?#

Yes, full key values are visible in the key list on Settings > API Keys. The Platform decrypts and displays your keys so you can copy them anytime.

Link to this sectionAnahtarlar bölgeye özgü mü?#

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

Link to this sectionAnahtarları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.