API Anahtarları

Ultralytics API anahtarları, uzaktan eğitim, çıkarım ve otomasyon için güvenli programlı 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ı'na gidin.
2. Anahtar Oluştur'u tıklayın
3. Anahtar için bir ad girin
4. İzin kapsamlarını seçin
5. Oluştur'u 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 Ekran

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

Anahtar Biçimi

API anahtarları şu biçimi izler:

ul_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

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

API Anahtarlarını Kullanma

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

Python dosyalarınızda anahtarı 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ı

API isteklerine anahtarı ekleyin:

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=yolo11n.pt data=coco.yaml project=username/project name=exp1

Anahtarları Yönet

Görüntüleme Tuşları

Tüm anahtarlar Ayarlar > API Anahtarları altında listelenmiştir:

Anahtarı iptal et

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

1. Tuşun menüsünü tıklayın
2. İptal Et'i seçin
3. İptali onayla

Anahtarı Yeniden Oluştur

Bir anahtar tehlikeye girerse:

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

Güvenlik En İyi Uygulamaları

Yap

• Anahtarları ortam değişkenlerinde saklayın
• Farklı ortamlar için ayrı anahtarlar kullanın
• Kullanılmayan anahtarları derhal iptal edin
• Gerekli minimum kapsamları kullanın
• Anahtarları periyodik olarak döndürün

Yapma

• Anahtarları sürüm kontrolüne ekle
• Uygulamalar arasında anahtarları paylaşın
• Yönetici kapsamını gereksiz yere kullanma
• Uygulama çıktısında anahtarları günlüğe kaydet
• Anahtarları istemci tarafı koduna yerleştirin

Anahtar Döndürme

Güvenlik için anahtarları periyodik olarak değiştirin:

1. Aynı kapsamlara sahip yeni anahtar oluşturun
2. Yeni anahtarı kullanmak için uygulamaları güncelleyin
3. Uygulamaların doğru çalıştığını doğrulayın
4. Eski anahtarı iptal et

Sorun Giderme

Geçersiz Anahtar Hatası

Error: Invalid API key

Çözümler:

1. Anahtarın doğru şekilde kopyalandığını doğrulayın
2. Anahtarın iptal edilmediğini kontrol edin
3. Anahtarın gerekli kapsamlara sahip olduğundan emin olun
4. Çevre değişkeninin ayarlandığını onaylayın

İzin Reddedildi

Error: Permission denied for this operation

Çözümler:

1. Anahtar kapsamlarını kontrol edin, gerekli izinleri içerir
2. Kaynak sahibinin siz olduğunuzu doğrulayın
3. Doğru kapsamlarla yeni anahtar oluşturun

Sınırlı Oran

Error: Rate limit exceeded

Çözümler:

1. İstek sıklığını azaltın
2. Üstel geri çekilme uygulayın
3. Limit artırımı için destek ekibiyle iletişime geçin

SSS

Kaç tane anahtar oluşturabilirim?

API anahtarları için kesin bir sınır yoktur. Farklı uygulamalar ve ortamlar için ihtiyaç duyduğunuz kadar anahtar oluşturabilirsiniz.

Anahtarların geçerlilik süresi var mı?

Anahtarlar otomatik olarak geçerliliğini yitirmez. İptal edilene kadar geçerliliğini korur. Güvenlik için rotasyon uygulamasını düşünün.

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

Hayır, tam anahtar yalnızca oluşturulduğunda bir kez gösterilir. Kaybolursa, yeni bir anahtar oluşturun ve eskisini iptal edin.

Anahtarlar bölgeye özgü mü?

Anahtarlar tüm bölgelerde çalışır, ancak yalnızca hesabınızın bulunduğu bölgedeki verilere erişebilir.

Anahtarları ekip üyeleriyle paylaşabilir miyim?

Daha iyi uygulama: Her ekip üyesinin kendi anahtarını oluşturmasını sağlayın. Bu, aşağıdakileri mümkün kılar:

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

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

Yorumlar