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 belirli izinlere sahip kapsamlı anahtarlar oluşturun.

API Anahtarı Oluştur

Yeni bir API anahtarı oluşturun:

1. Ayarlar > API Anahtarları bölümüne gidin
2. Anahtar Oluştur düğmesine tıklayın
3. Anahtar için bir ad girin
4. İzin kapsamlarını seçin
5. Oluştur'a 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
• mobile-app - Mobil uygulamalar için

İzin Kapsamları

Anahtar izinlerini sınırlamak için kapsamları seç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_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

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

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"

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/...

Uzaktan Eğitim

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

pip install "ultralytics>=8.4.0"

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

Anahtarları Yönet

Anahtarları Görüntüle

Tüm anahtarlar Ayarlar > API Anahtarları bölümünde listelenmiştir:

Anahtarı İptal Et

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

1. Anahtarın menüsüne tıklayın
2. İptal Et seçeneğini belirleyin
3. İptali onaylayın

Anahtarı Yeniden Oluştur

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

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

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
• Minimum gerekli kapsamları kullanın
• Anahtarları periyodik olarak değiştirin

Yapılmaması Gerekenler

• Anahtarları sürüm kontrolüne işleyin
• Anahtarları uygulamalar arasında paylaşın
• Yönetici kapsamını gereksiz yere kullanma
• 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ı kapsamlara sahip 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
2. Anahtarın iptal edilmediğini kontrol edin
3. Anahtarın gerekli kapsamlara sahip olduğundan emin olun
4. Ortam değişkeninin ayarlandığını onaylayın

İzin Reddedildi

Error: Permission denied for this operation

Çözümler:

1. Anahtar kapsamlarının gerekli izni içerdiğini kontrol edin
2. Kaynak sahibi olduğunuzu doğrulayın
3. Doğru kapsamlara sahip yeni anahtar oluşturun

Oran Sınırlandırıldı

Error: Rate limit exceeded

Çözümler:

1. İstek sıklığını azaltın
2. Üstel geri çekilmeyi uygulayın
3. Limit artışı için destekle iletişime geçin

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?

Hayır, anahtarın tamamı yalnızca oluşturma sırasında bir kez gösterilir. Kaybolursa, yeni bir anahtar oluşturun ve eskisini iptal edin.

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. Bu şunları sağlar:

• Bireysel etkinlik takibi
• Seçici iptal
• Uygun erişim kontrolü

📅 20 gün önce oluşturuldu ✏️ 19 gün önce güncellendi

Yorumlar