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 şifrelemesi ile adlandırılmış anahtarlar oluşturun.

API Anahtarı Oluştur

Yeni bir API anahtarı oluşturun:

1. Ayarlar > Profil bölümüne gidin
2. API Anahtarları bölümüne ilerleyin
3. Anahtar Oluştur düğmesine tıklayın
4. Anahtar için bir ad girin (örn. "Eğitim Sunucusu")
5. Anahtar Oluştur düğmesine tıklayın

Anahtar Adı

Anahtarınıza açıklayıcı bir ad verin:

• 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 kez görüntülenir:

Anahtar Biçimi

API anahtarları şu formatı takip eder:

ul_a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4

• Ön Ek: ul_ Ultralytics anahtarlarını tanımlar
• Gövde: 40 rastgele onaltılık karakter
• Toplam: 43 karakter

Anahtar Güvenliği

• Anahtarlar AES-256-GCM şifrelemesi ile saklanır
• Kimlik doğrulama, hızlı ön ek araması ve hash karşılaştırması için SHA-256 hash kullanır
• Tam anahtar değerleri asla düz metin olarak saklanmaz

API Anahtarlarını Kullanma

Ortam Değişkeni

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

export ULTRALYTICS_API_KEY="ul_your_key_here"

$env:ULTRALYTICS_API_KEY = "ul_your_key_here"

YOLO CLI

Anahtarı YOLO CLI kullanarak ayarlayın:

yolo settings api_key="ul_your_key_here"

Kodda

Anahtarı Python betiklerinizde kullanın:

import os

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

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

HTTP Başlıkları

Anahtarı API isteklerine dahil edin:

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

Mevcut tüm uç noktalar için REST API Referansı'na bakın.

Uzaktan Eğitim

Anahtarınızla metrik akışını etkinleştirin.

pip install "ultralytics>=8.4.14"

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

Eksiksiz uzaktan eğitim kılavuzu için Bulut Eğitimi'ne bakın.

Anahtarları Yönet

Anahtarları Görüntüle

Tüm anahtarlar şurada listelenmiştir: Settings > Profile API Anahtarları bölümünün altında:

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.

Anahtarı İptal Et

Güvenliği ihlal edilmiş veya artık gerekmeyen bir anahtarı iptal edin:

1. Anahtarı API Anahtarları bölümünde bulun
2. İptal Et (çöp kutusu) düğmesine tıklayın
3. İptali onaylayın

Anahtarı Yeniden Oluştur

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

1. Aynı adla yeni bir anahtar oluşturun
2. Uygulamalarınızı güncelleyin
3. Eski anahtarı iptal edin

Ç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ız 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ş yapıldığında, 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 daha yüksek bir rol gereklidir. Rol ayrıntıları için Ekipler'e bakın.

Güvenlik En İyi Uygulamaları

Yapılması Gerekenler

• Anahtarları ortam değişkenlerinde saklayın
• Farklı ortamlar için ayrı anahtarlar kullanın
• Kullanılmayan anahtarları derhal iptal edin
• Anahtarları periyodik olarak değiştirin
• Anahtar amaçlarını belirlemek için açıklayıcı adlar kullanın

Yapılmaması Gerekenler

• Anahtarları sürüm kontrolüne işleyin
• Anahtarları uygulamalar arasında paylaşın
• Uygulama çıktısında anahtarları kaydetme
• Anahtarları istemci tarafı koda gömme

Anahtar Rotasyonu

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

1. Aynı adla yeni anahtar oluşturun
2. Uygulamaları yeni anahtarı kullanacak şekilde güncelleyin
3. Uygulamaların doğru çalıştığını doğrulayın
4. Eski anahtarı iptal edin

Sorun Giderme

Geçersiz Anahtar Hatası

Error: Invalid API key

Çözümler:

1. Anahtarın doğru kopyalandığını doğrulayın (şunu da içerecek şekilde: ul_ önek)
2. Anahtarın iptal edilmediğini kontrol edin
3. Ortam değişkeninin ayarlandığını onaylayın
4. Kullandığınızdan emin olun ultralytics>=8.4.14

İzin Reddedildi

Error: Permission denied for this operation

Çözümler:

1. Kaynak sahibi olduğunuzu veya uygun çalışma alanı erişimine sahip olduğunuzu doğrulayın
2. Anahtarın doğru çalışma alanına ait olduğunu kontrol edin
3. Gerekirse yeni bir anahtar oluşturun

Oran Sınırlandırıldı

Error: Rate limit exceeded

Çözümler:

1. İstek sıklığını azaltın — uç nokta başına limitler için oran limiti tablosuna bakın
2. Şunu kullanarak üstel geri çekilmeyi uygulayın Retry-After Başlık
3. Sınırsız çıkarım verimi için özel bir uç nokta kullanın

SSS

Kaç anahtar oluşturabilirim?

API anahtarları için kesin bir sınır yoktur. Farklı uygulamalar ve ortamlar için gerektiği kadar oluşturun.

Anahtarların süresi dolar mı?

Anahtarlar otomatik olarak sona ermez. İptal edilene kadar geçerli kalırlar. Güvenlik için rotasyon uygulamayı düşünün.

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

Evet, tüm anahtar değerleri anahtar listesinde görünür Settings > Profile. Platform, anahtarlarınızı şifresini çözerek görüntüler, böylece istediğiniz zaman kopyalayabilirsiniz.

Anahtarlar bölgeye özel mi?

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

Anahtarları ekip üyeleriyle paylaşabilir miyim?

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

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

Yorumlar