Link to this sectionChiavi API#

Le chiavi API della Ultralytics Platform consentono un accesso programmatico sicuro per l'addestramento remoto, l'inferenza e l'automazione. Crea chiavi denominate con crittografia AES-256-GCM per diversi casi d'uso.

Link to this sectionCrea chiave API#

Crea una nuova chiave API:

1. Vai su Impostazioni > Chiavi API
2. Clicca su Crea chiave
3. Inserisci un nome per la chiave (ad es. "Server di addestramento")
4. Clicca su Crea chiave

Link to this sectionNome chiave#

Dai alla tua chiave un nome descrittivo:

• training-server - Per macchine di addestramento remoto
• ci-pipeline - Per integrazione CI/CD
• local-dev - Per sviluppo locale

Link to this sectionVisualizzazione chiave#

Dopo la creazione, la chiave viene visualizzata una sola volta:

Link to this sectionFormato chiave#

Le chiavi API seguono questo formato:

• Prefisso: ul_ identifica le chiavi Ultralytics
• Corpo: 40 caratteri esadecimali casuali
• Totale: 43 caratteri

Link to this sectionSicurezza della chiave#

• Le chiavi vengono memorizzate con crittografia AES-256-GCM
• L'autenticazione utilizza l'hash SHA-256 per una rapida ricerca del prefisso e il confronto degli hash
• I valori completi delle chiavi non vengono mai memorizzati in formato testo in chiaro

Link to this sectionUtilizzo delle chiavi API#

Link to this sectionVariabile d'ambiente#

Imposta la tua chiave come variabile d'ambiente:

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

Link to this sectionYOLO CLI#

Imposta la chiave utilizzando la YOLO CLI:

yolo settings api_key="YOUR_API_KEY"

Link to this sectionNel codice#

Utilizza la chiave nei tuoi script Python:

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 sectionIntestazioni HTTP#

Includi la chiave nelle richieste API:

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

Consulta il Riferimento REST API per tutti gli endpoint disponibili.

Link to this sectionAddestramento remoto#

Abilita lo streaming delle metriche con la tua chiave.

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

Consulta Addestramento nel cloud per la guida completa all'addestramento remoto.

Link to this sectionGestione chiavi#

Link to this sectionVisualizza chiavi#

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

Ogni scheda chiave mostra il nome della chiave, il valore completo della chiave decodificata (copiabile), il tempo di creazione relativo e un pulsante di revoca.

Link to this sectionRevoca chiave#

Revoca una chiave che è compromessa o non più necessaria:

1. Trova la chiave nella sezione Chiavi API
2. Clicca sul pulsante Revoca (cestino)
3. Conferma la revoca

Link to this sectionRigenera chiave#

Se una chiave è compromessa:

1. Crea una nuova chiave con lo stesso nome
2. Aggiorna le tue applicazioni
3. Revoca la vecchia chiave

Link to this sectionChiavi API dell'area di lavoro#

Le chiavi API sono limitate all'area di lavoro attualmente attiva:

• Area di lavoro personale: Le chiavi autenticano come il tuo account personale
• Area di lavoro del team: Le chiavi autenticano all'interno del contesto del team

Quando si cambiano le aree di lavoro nella barra laterale, la sezione Chiavi API mostra le chiavi per quell'area di lavoro. Per gestire le chiavi API dell'area di lavoro è richiesto il ruolo Editor o superiore. Consulta Team per i dettagli sui ruoli.

Link to this sectionMigliori pratiche di sicurezza#

Link to this sectionCose da fare#

• Memorizza le chiavi nelle variabili d'ambiente
• Usa chiavi separate per ambienti diversi
• Revoca tempestivamente le chiavi inutilizzate
• Ruota periodicamente le chiavi
• Usa nomi descrittivi per identificare gli scopi delle chiavi

Link to this sectionCose da evitare#

• Eseguire il commit delle chiavi nel controllo versione
• Condividere le chiavi tra diverse applicazioni
• Registrare le chiavi nell'output dell'applicazione
• Incorporare le chiavi nel codice lato client

Link to this sectionRotazione delle chiavi#

Ruota periodicamente le chiavi per motivi di sicurezza:

1. Crea una nuova chiave con lo stesso nome
2. Aggiorna le applicazioni per usare la nuova chiave
3. Verifica che le applicazioni funzionino correttamente
4. Revoca la vecchia chiave

Link to this sectionRisoluzione dei problemi#

Link to this sectionErrore di chiave non valida#

Soluzioni:

1. Verifica che la chiave sia copiata correttamente (incluso il prefisso ul_)
2. Controlla che la chiave non sia stata revocata
3. Conferma che la variabile d'ambiente sia impostata
4. Assicurati di utilizzare ultralytics>=8.4.60

Link to this sectionPermesso negato#

Soluzioni:

1. Verifica di essere il proprietario della risorsa o di avere un accesso appropriato all'area di lavoro
2. Controlla che la chiave appartenga all'area di lavoro corretta
3. Crea una nuova chiave se necessario

Link to this sectionLimite di frequenza raggiunto#

Soluzioni:

1. Riduci la frequenza delle richieste — consulta la tabella dei limiti di frequenza per i limiti per endpoint
2. Implementa il backoff esponenziale utilizzando l'intestazione Retry-After
3. Utilizza un endpoint dedicato per un throughput di inferenza illimitato

Link to this sectionFAQ#

Link to this sectionQuante chiavi posso creare?#

Non esiste un limite rigido alle chiavi API. Crea tutte quelle necessarie per diverse applicazioni e ambienti.

Link to this sectionLe chiavi scadono?#

Le chiavi non scadono automaticamente. Rimangono valide finché non vengono revocate. Valuta di implementare la rotazione per motivi di sicurezza.

Link to this sectionPosso vedere la mia chiave dopo la creazione?#

Sì, i valori completi delle chiavi sono visibili nell'elenco delle chiavi in Settings > API Keys. La piattaforma decrittografa e visualizza le tue chiavi in modo che tu possa copiarle in qualsiasi momento.

Link to this sectionLe chiavi sono specifiche per regione?#

Le chiavi funzionano in tutte le regioni, ma accedono solo ai dati nella regione del tuo account.

Link to this sectionPosso condividere le chiavi con i membri del team?#

Pratica migliore: fai in modo che ogni membro del team crei la propria chiave. Per gli spazi di lavoro del team, ogni membro con ruolo Editor o superiore può creare chiavi limitate a quello spazio di lavoro.