Link to this sectionAPI-Schlüssel#

Ultralytics Platform API-Schlüssel ermöglichen sicheren, programmatischen Zugriff für Remote-Training, Inferenz und Automatisierung. Erstelle benannte Schlüssel mit AES-256-GCM-Verschlüsselung für verschiedene Anwendungsfälle.

Link to this sectionAPI-Schlüssel erstellen#

Erstelle einen neuen API-Schlüssel:

1. Gehe zu Einstellungen > API-Schlüssel
2. Klicke auf Schlüssel erstellen
3. Gib einen Namen für den Schlüssel ein (z. B. "Training Server")
4. Klicke auf Schlüssel erstellen

Link to this sectionSchlüsselname#

Gib deinem Schlüssel einen beschreibenden Namen:

• training-server - Für Remote-Trainingsmaschinen
• ci-pipeline - Für CI/CD-Integration
• local-dev - Für lokale Entwicklung

Link to this sectionSchlüsselanzeige#

Nach der Erstellung wird der Schlüssel einmalig angezeigt:

Link to this sectionSchlüsselformat#

API-Schlüssel folgen diesem Format:

• Präfix: ul_ identifiziert Ultralytics-Schlüssel
• Körper: 40 zufällige hexadezimale Zeichen
• Gesamt: 43 Zeichen

Link to this sectionSchlüsselsicherheit#

• Schlüssel werden mit AES-256-GCM-Verschlüsselung gespeichert
• Die Authentifizierung nutzt einen SHA-256-Hash für schnelle Präfix-Suche und Hash-Vergleich
• Vollständige Schlüsselwerte werden niemals im Klartext gespeichert

Link to this sectionVerwendung von API-Schlüsseln#

Link to this sectionUmgebungsvariable#

Setze deinen Schlüssel als Umgebungsvariable:

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

Link to this sectionYOLO CLI#

Setze den Schlüssel über das YOLO CLI:

yolo settings api_key="YOUR_API_KEY"

Link to this sectionIm Code#

Verwende den Schlüssel in deinen Python-Skripten:

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-Header#

Füge den Schlüssel in API-Anfragen ein:

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

Siehe die REST API Referenz für alle verfügbaren Endpunkte.

Link to this sectionRemote-Training#

Aktiviere Metrik-Streaming mit deinem Schlüssel.

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

Siehe Cloud Training für das vollständige Handbuch zum Remote-Training.

Link to this sectionSchlüssel verwalten#

Link to this sectionSchlüssel anzeigen#

All keys are listed on the Settings > API Keys tab:

Jede Schlüsselkarte zeigt den Namen, den vollständigen entschlüsselten Wert (kopierbar), den relativen Erstellungszeitpunkt und eine Schaltfläche zum Widerrufen.

Link to this sectionSchlüssel widerrufen#

Widerrufe einen Schlüssel, der kompromittiert wurde oder nicht mehr benötigt wird:

1. Finde den Schlüssel im Abschnitt API-Schlüssel
2. Klicke auf die Widerrufen (Papierkorb) Schaltfläche
3. Widerruf bestätigen

Link to this sectionSchlüssel neu generieren#

Wenn ein Schlüssel kompromittiert wurde:

1. Erstelle einen neuen Schlüssel mit demselben Namen
2. Aktualisiere deine Anwendungen
3. Widerrufe den alten Schlüssel

Link to this sectionWorkspace API-Schlüssel#

API-Schlüssel sind auf den aktuell aktiven Workspace beschränkt:

• Persönlicher Workspace: Schlüssel authentifizieren sich als dein persönliches Konto
• Team-Workspace: Schlüssel authentifizieren sich im Kontext des Teams

Beim Wechseln der Workspaces in der Seitenleiste zeigt der Bereich API-Schlüssel die Schlüssel für diesen Workspace an. Die Editor-Rolle oder höher ist erforderlich, um Workspace-API-Schlüssel zu verwalten. Siehe Teams für Rollendetails.

Link to this sectionBest Practices für Sicherheit#

Link to this sectionDo#

• Speichere Schlüssel in Umgebungsvariablen
• Verwende separate Schlüssel für verschiedene Umgebungen
• Widerrufe ungenutzte Schlüssel zeitnah
• Rotiere Schlüssel regelmäßig
• Verwende beschreibende Namen, um die Zwecke der Schlüssel zu identifizieren

Link to this sectionDon't#

• Commite keine Schlüssel in die Versionskontrolle
• Teile keine Schlüssel zwischen Anwendungen
• Logge keine Schlüssel in die Anwendungsausgabe
• Bette keine Schlüssel in clientseitigen Code ein

Link to this sectionSchlüsselrotation#

Rotiere Schlüssel regelmäßig aus Sicherheitsgründen:

1. Erstelle einen neuen Schlüssel mit demselben Namen
2. Aktualisiere Anwendungen, um den neuen Schlüssel zu verwenden
3. Überprüfe, ob die Anwendungen korrekt funktionieren
4. Widerrufe den alten Schlüssel

Link to this sectionFehlerbehebung#

Link to this sectionFehler: Ungültiger Schlüssel#

Lösungen:

1. Überprüfe, ob der Schlüssel korrekt kopiert wurde (einschließlich des ul_ Präfixes)
2. Prüfe, ob der Schlüssel widerrufen wurde
3. Bestätige, dass die Umgebungsvariable gesetzt ist
4. Stelle sicher, dass du ultralytics>=8.4.60 verwendest

Link to this sectionZugriff verweigert#

Lösungen:

1. Überprüfe, ob du der Ressourcenbesitzer bist oder den entsprechenden Workspace-Zugriff hast
2. Prüfe, ob der Schlüssel zum korrekten Workspace gehört
3. Erstelle bei Bedarf einen neuen Schlüssel

Link to this sectionRatenbegrenzung#

Lösungen:

1. Reduziere die Anfragenhäufigkeit — siehe die Ratenbegrenzungstabelle für Grenzwerte pro Endpunkt
2. Implementiere exponentielles Backoff unter Verwendung des Retry-After Headers
3. Verwende einen dedizierten Endpunkt für unbegrenzten Inferenz-Durchsatz

Link to this sectionFAQ#

Link to this sectionWie viele Schlüssel kann ich erstellen?#

Es gibt kein hartes Limit für API-Schlüssel. Erstelle so viele wie für verschiedene Anwendungen und Umgebungen benötigt werden.

Link to this sectionLaufen Schlüssel ab?#

Schlüssel laufen nicht automatisch ab. Sie bleiben gültig, bis sie widerrufen werden. Erwäge zur Sicherheit eine Rotation.

Link to this sectionKann ich meinen Schlüssel nach der Erstellung sehen?#

Ja, die vollständigen Schlüsselwerte sind in der Schlüsselliste unter Settings > API Keys sichtbar. Die Plattform entschlüsselt und zeigt deine Schlüssel an, damit du sie jederzeit kopieren kannst.

Link to this sectionSind Schlüssel regionsspezifisch?#

Schlüssel funktionieren regionsübergreifend, greifen aber nur auf Daten in der Region deines Accounts zu.

Link to this sectionKann ich Schlüssel mit Teammitgliedern teilen?#

Bessere Praxis: Lass jedes Teammitglied seinen eigenen Schlüssel erstellen. Für Team-Arbeitsbereiche kann jedes Mitglied mit der Rolle Editor oder höher Schlüssel erstellen, die auf diesen Arbeitsbereich beschränkt sind.