Chiavi API

Le chiavi API Ultralytics consentono un accesso programmatico sicuro per la formazione remota, l'inferenza e l'automazione. Crea chiavi con ambito specifico e autorizzazioni specifiche per diversi casi d'uso.

Crea chiave API

Crea una nuova chiave API:

1. Vai su Impostazioni > Chiavi API
2. Fai clic su Crea chiave
3. Inserisci un nome per la chiave
4. Seleziona gli ambiti di autorizzazione
5. Clicca su Crea

Nome chiave

Assegna alla tua chiave un nome descrittivo:

• training-server - Per macchine di addestramento a distanza
• ci-pipeline - Per l'integrazione CI/CD
• mobile-app - Per applicazioni mobili

Ambito delle autorizzazioni

Selezionare gli ambiti per limitare le autorizzazioni chiave:

Visualizzazione tasti

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

Formato chiave

Le chiavi API seguono questo formato:

ul_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

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

Utilizzo delle chiavi API

Variabile d'ambiente

Imposta la tua chiave come variabile d'ambiente:

export ULTRALYTICS_API_KEY="ul_your_key_here"

$env:ULTRALYTICS_API_KEY = "ul_your_key_here"

Nel codice

Utilizza la chiave nei tuoi Python :

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"

Intestazioni HTTP

Includere la chiave nelle richieste API:

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

Formazione a distanza

Abilita lo streaming delle metriche con la tua chiave.

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

Gestisci chiavi

Tasti di visualizzazione

Tutte le chiavi sono elencate in Impostazioni > Chiavi API:

Revoca chiave

Revoca una chiave compromessa o non più necessaria:

1. Clicca sul menu della chiave
2. Seleziona Revoca
3. Conferma revoca

Rigenera chiave

Se una chiave viene compromessa:

1. Crea una nuova chiave con gli stessi ambiti
2. Aggiorna le tue applicazioni
3. Revoca la vecchia chiave

Migliori pratiche di sicurezza

Fai

• Memorizza le chiavi nelle variabili d'ambiente
• Utilizza chiavi separate per ambienti diversi
• Revoca tempestivamente le chiavi inutilizzate
• Utilizzare gli ambiti minimi richiesti
• Ruotare periodicamente le chiavi

Non

• Inserisci le chiavi nel controllo di versione
• Condividi le chiavi tra le applicazioni
• Utilizzo non necessario dell'ambito amministrativo
• Registra le chiavi nell'output dell'applicazione
• Incorporare le chiavi nel codice lato client

Rotazione chiave

Ruotare periodicamente le chiavi per motivi di sicurezza:

1. Crea una nuova chiave con gli stessi ambiti
2. Aggiornare le applicazioni per utilizzare la nuova chiave
3. Verificare che le applicazioni funzionino correttamente
4. Revoca vecchia chiave

Risoluzione dei problemi

Errore chiave non valida

Error: Invalid API key

Soluzioni:

1. Verificare che la chiave sia stata copiata correttamente
2. Verifica che la chiave non sia stata revocata
3. Assicurarsi che la chiave abbia gli ambiti richiesti
4. Verificare che la variabile di ambiente sia impostata

Autorizzazione negata

Error: Permission denied for this operation

Soluzioni:

1. Controllare che gli ambiti delle chiavi includano le autorizzazioni richieste
2. Verifica di essere il proprietario della risorsa
3. Crea una nuova chiave con gli ambiti corretti

Velocità limitata

Error: Rate limit exceeded

Soluzioni:

1. Ridurre la frequenza delle richieste
2. Implementare il backoff esponenziale
3. Contatta l'assistenza per aumentare il limite

FAQ

Quante chiavi posso creare?

Non ci sono limiti rigidi per le chiavi API. Creane quante ne servono per le diverse applicazioni e ambienti.

Le chiavi hanno una scadenza?

Le chiavi non scadono automaticamente. Rimangono valide fino alla loro revoca. Per motivi di sicurezza, è consigliabile implementare una rotazione periodica.

Posso vedere la mia chiave dopo averla creata?

No, la chiave completa viene mostrata solo una volta al momento della creazione. Se la perdi, crea una nuova chiave e revoca quella vecchia.

Le chiavi sono specifiche per regione?

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

Posso condividere le chiavi con i membri del team?

Pratica migliore: chiedere a ciascun membro del team di creare la propria chiave. Ciò consente di:

• Monitoraggio delle attività individuali
• Revoca selettiva
• Controllo adeguato degli accessi

📅 Creato 0 giorni fa ✏️ Aggiornato 0 giorni fa

Commenti