Guida rapida a Ultralytics Platform
Ultralytics Platform è progettata per essere user-friendly e intuitiva, consentendo agli utenti di caricare rapidamente i propri dataset e addestrare nuovi modelli YOLO. Offre una gamma di modelli pre-addestrati tra cui scegliere, facilitando l'inizio per gli utenti. Una volta addestrato un modello, può essere testato direttamente nel browser e distribuito in produzione con un solo clic.
journey
title Your First Model in 5 Minutes
section Sign Up
Create account: 5: User
Select region: 5: User
section Prepare Data
Upload dataset: 5: User
Review images: 4: User
section Train
Configure training: 5: User
Monitor progress: 3: Platform
section Deploy
Test model: 5: User
Deploy endpoint: 5: User
Inizia
Ultralytics offre diverse opzioni di registrazione semplici. È possibile registrarsi e accedere utilizzando i propri account Google GitHub oppure il proprio indirizzo e-mail.

Selezione della Regione
Durante la fase di onboarding, ti verrà chiesto di selezionare la tua regione dati. La piattaforma misura automaticamente la latenza di ciascuna regione e consiglia quella più vicina. Si tratta di una scelta importante, poiché determina dove verranno archiviati i tuoi dati, modelli e distribuzioni.

| Regione | Etichetta | Località | Ideale per |
|---|---|---|---|
| USA | Americhe | Iowa, USA | Utenti delle Americhe, il più veloce per le Americhe |
| UE | Europa, Medio Oriente e Africa | Belgio, Europa | Utenti europei, conformità GDPR |
| AP | Asia-Pacifico | Hong Kong, Asia-Pacifico | Utenti dell'area Asia-Pacifico, latenza APAC più bassa |
La regione è permanente
La selezione della regione non può essere modificata dopo la creazione dell'account. Scegli la regione più vicina a te o ai tuoi utenti per le migliori prestazioni.
Crediti gratuiti
Ogni nuovo account riceve crediti gratuiti per GPU cloud:
| Tipo di e-mail | Crediti di iscrizione | Come qualificarsi |
|---|---|---|
| E-mail di lavoro/aziendale | $25.00 | Utilizza il dominio della tua azienda (@azienda.com) |
| Email personale | $5.00 | Gmail, Yahoo, Outlook, ecc. |
Ottimizza i tuoi crediti
Iscriviti con un indirizzo e-mail di lavoro per ricevere 25 $ di credito. Se ti sei registrato con un indirizzo e-mail personale, puoi verificare un indirizzo e-mail di lavoro in un secondo momento per sbloccare ulteriori 20 $ di credito.
Completa il tuo Profilo
Prima di selezionare la tua regione, dovrai completare il tuo profilo con un nome visualizzato, un nome utente, un'azienda facoltativa e un caso d'uso principale. Il flusso di onboarding prevede tre passaggi: Profilo, Regione dati e Completa.

Aggiorna in seguito
Puoi aggiornare il tuo profilo in qualsiasi momento dalla pagina Impostazioni, inclusi il nome visualizzato, la biografia e i link ai social. Tieni presente che il nome utente non può essere modificato dopo la registrazione.
Dashboard principale
Dopo aver effettuato l'accesso, verrai indirizzato alla pagina iniziale della Ultralytics , che fornisce una scheda di benvenuto con le statistiche dell'area di lavoro, l'accesso rapido ai set di dati, ai progetti e all'archivio, nonché un feed delle attività recenti.

Navigazione laterale
La barra laterale consente di accedere a tutte le sezioni della piattaforma:
| Sezione | Articolo | Descrizione |
|---|---|---|
| Inizio pagina | Cerca | Ricerca rapida in tutte le tue risorse (Cmd+K) |
| Home | Dashboard con azioni rapide e attività recenti | |
| Esplora | Scopri i progetti pubblici e i set di dati | |
| I miei progetti | Annota | I tuoi set di dati organizzati per l'annotazione |
| Addestramento | I tuoi progetti contenenti modelli addestrati | |
| Distribuisci | Le tue implementazioni attive | |
| Fondo | Cestino | Elementi eliminati (recuperabili per 30 giorni) |
| Impostazioni | Account, fatturazione e preferenze | |
| Feedback | Invia feedback a Ultralytics |
Biglietto di benvenuto
La scheda di benvenuto mostra il tuo profilo, il badge del piano e le statistiche dell'area di lavoro a colpo d'occhio:
| Stat | Descrizione |
|---|---|
| Set di dati | Numero di set di dati |
| Immagini | Immagini totali in tutti i set di dati |
| Annotazioni | Numero totale di annotazioni |
| Progetti | Numero di progetti |
| Modelli | Modelli addestrati totali |
| Esportazioni | Numero di esportazioni del modello |
| Deployment | Numero di implementazioni attive |
Azioni rapide
Sotto il biglietto di benvenuto, la dashboard mostra tre schede:
- Set di dati: crea un nuovo set di dati o trascina immagini, video o file ZIP da caricare. Mostra i tuoi set di dati recenti.
- Progetti: Crea un nuovo progetto o rilascia
.ptfile modello da caricare. Mostra i tuoi progetti recenti. - Archiviazione: panoramica dell'utilizzo dello spazio di archiviazione (set di dati, modelli, esportazioni) con i limiti del piano.
La tabella Attività recenti nella parte inferiore mostra i tuoi ultimi set di dati, modelli e sessioni di formazione.
Carica il tuo primo Dataset
Vai a Annotate nella barra laterale e clicca New Dataset per aggiungere i tuoi dati di addestramento. Puoi anche trascinare i file direttamente sulla scheda Dataset nella dashboard Home.

Ultralytics supporta diversi formati di caricamento (maggiori dettagli nella sezione Set di dati):
| Formato | Dimensione massima | Descrizione |
|---|---|---|
| Immagini | 50 MB | JPG, PNG, WebP, TIFF e altri formati comuni |
| Archivio ZIP | 10 GB | Cartella compressa con immagini ed etichette |
| Video | 1 GB | MP4, AVI - fotogrammi estratti a ~1 fps (max 100 fotogrammi) |
| Formato YOLO | 10 GB | Struttura standard del dataset YOLO con etichette |
graph LR
A[Drop Files] --> B[Auto-Package ZIP]
B --> C[Upload to Storage]
C --> D[Backend Worker]
D --> E[Resize & Thumbnail]
E --> F[Parse Labels]
F --> G[Compute Statistics]
G --> H[Dataset Ready]
Dopo il caricamento, la piattaforma elabora automaticamente i tuoi dati:
- Le immagini più grandi di 4096px vengono ridimensionate (mantenendo le proporzioni).
- Vengono generate miniature da 256 px per una navigazione veloce.
- Le etichette vengono analizzate e convalidate (YOLO
.txtformato) - Vengono calcolate le statistiche (distribuzione delle classi, mappe di calore, dimensioni)
Struttura YOLO
Per ottenere risultati ottimali, carica un file ZIP con la YOLO standard:
my-dataset.zip
├── data.yaml # Class names and splits
├── train/
│ ├── images/
│ │ ├── img001.jpg
│ │ └── img002.jpg
│ └── labels/
│ ├── img001.txt
│ └── img002.txt
└── val/
├── images/
└── labels/
Per la sintassi completa delle attività, vedere detect, segment, pose, OBB e classify guide ai set di dati.
Maggiori informazioni sui set di dati e sui formati supportati per il detect, segment, pose, OBB e classify.
Crea il tuo primo Progetto
I progetti ti aiutano a organizzare modelli ed esperimenti correlati. Vai alla sezione Progetti e clicca su "Crea Progetto".

Inserisci un nome e una descrizione facoltativa per il tuo progetto. I progetti contengono:
- Modelli: Checkpoint addestrati
- Registro attività: Cronologia delle modifiche
Maggiori informazioni sui progetti.
Addestra il tuo primo Modello
Dal tuo progetto, clicca su Train Model per iniziare la formazione sul cloud.

Configurazione dell'Addestramento
- Seleziona set di dati: Scegli tra i set di dati caricati (solo i set di dati con un
traindivisione sono mostrati) - Scegli il modello: seleziona un modello di base, ovvero Ultralytics ufficiali Ultralytics o i tuoi modelli addestrati.
- Imposta epoche: numero di iterazioni di addestramento (impostazione predefinita: 100)
- Seleziona GPU: scegli le risorse di calcolo in base al tuo budget e alle dimensioni del modello
| Modello | Dimensione | Velocità | Accuratezza | GPU consigliata |
|---|---|---|---|---|
| YOLO26n | Nano | Il più Veloce | Buono | RTX PRO 6000 (96 GB) |
| YOLO26s | Piccola | Veloce | Migliore | RTX PRO 6000 (96 GB) |
| YOLO26m | Media | Moderata | Alta | RTX PRO 6000 (96 GB) |
| YOLO26l | Grande | Più lenta | Maggiore | A100 (80 GB) |
| YOLO26x | Extra Grande | La più lenta | Migliore | H100 (80 GB) |
Selezione GPU
Le GPU vanno da 0,24 $/ora (RTX 2000 Ada, 16 GB) a 4,99 $/ora (B200, 180 GB). La GPU predefinita GPU RTX PRO 6000 (96 GB Blackwell, 1,89 $/ora), che offre un ottimo equilibrio tra memoria e prestazioni. Consulta la tabella completa GPU per tutte le 22 opzioni.
Saldo credito richiesto
La formazione sul cloud richiede un saldo positivo sufficiente a coprire il costo stimato del lavoro. Controlla il tuo saldo in Settings > Billing. I nuovi account ricevono crediti gratuiti (5 $ per l'email personale, 25 $ per l'email di lavoro).
Monitorare l'addestramento
Una volta iniziata la formazione, è possibile monitorare i progressi in tempo reale attraverso tre sottoschede:
| Sottoscheda | Contenuto |
|---|---|
| Grafici | Curve di perdita di addestramento/validazione, mAP, precisione, richiamo |
| Console | Output del registro di allenamento in tempo reale |
| Sistema | GPU , utilizzo della memoria, metriche hardware |

Le metriche vengono trasmesse in tempo reale tramite SSE (Server-Sent Events). Al termine dell'addestramento, vengono generati grafici di convalida che includono matrici di confusione, curve PR e curve F1.
Annulla Addestramento
È possibile annullare un processo di formazione in esecuzione in qualsiasi momento. Verrà addebitato solo il tempo di elaborazione utilizzato fino a quel momento.
Per saperne di più sul training su cloud.
Testa il tuo Modello
Una volta completato il training, testa il tuo modello direttamente nel browser:
- Passa al tuo modello
Predictscheda - Carica un'immagine, trascinala o utilizza immagini di esempio (inferenza automatica al rilascio)
- Visualizza i risultati dell'inferenza con i riquadri di delimitazione renderizzati su tela

Regola i parametri di inferenza:
| Parametro | Predefinito | Descrizione |
|---|---|---|
| Confidenza | 0.25 | Filtra le previsioni a bassa affidabilità |
| IoU | 0.7 | Controllo della sovrapposizione per NMS |
| Dimensione dell'immagine | 640 | Ridimensiona input per inferenza |
Il Predict La scheda fornisce esempi di codice pronti all'uso con la tua chiave API effettiva già inserita:
import requests
url = "https://platform.ultralytics.com/api/models/{model_id}/predict"
headers = {"Authorization": "Bearer your_api_key"}
with open("image.jpg", "rb") as f:
response = requests.post(url, headers=headers, files={"file": f})
print(response.json())
curl -X POST "https://platform.ultralytics.com/api/models/{model_id}/predict" \
-H "Authorization: Bearer your_api_key" \
-F "file=@image.jpg"
Auto-inferenza
La scheda Predict esegue automaticamente l'inferenza quando si rilascia un'immagine, senza bisogno di cliccare su alcun pulsante. Le immagini di esempio (bus.jpg, zidane.jpg) sono precaricate per consentire un test immediato.
Per saperne di più sull'inferenza.
Distribuisci in Produzione
Distribuisci il tuo modello su un endpoint dedicato per l'uso in produzione:
- Passa al tuo modello
Deployscheda - Seleziona una regione dalla mappa interattiva del mondo (43 regioni disponibili)
- The map shows real-time latency measurements with traffic light colors (green < 100ms, yellow < 200ms, red > 200ms)
- Clicca
Deployper creare il tuo endpoint

graph LR
A[Select Region] --> B[Deploy]
B --> C[Provisioning ~1 min]
C --> D[Running]
D --> E{Lifecycle}
E --> F[Stop]
E --> G[Delete]
F --> H[Resume]
H --> D
Il tuo endpoint sarà pronto in circa un minuto con:
- URL Unico: Endpoint HTTPS per chiamate API
- Auto-Scaling: Si adatta automaticamente al traffico
- Monitoraggio: Metriche delle richieste e log
Ciclo di vita dell'implementazione
Gli endpoint possono essere avviati, arrestati ed eliminati. Gli endpoint arrestati non comportano costi di elaborazione, ma mantengono la loro configurazione. È possibile riavviare un endpoint arrestato con un solo clic.
Dopo l'implementazione, è possibile gestire tutti gli endpoint dal Deploy sezione nella barra laterale, che mostra una mappa globale con le distribuzioni attive, le metriche di panoramica e un elenco di tutti gli endpoint.
Per saperne di più sugli endpoint.
Formazione a distanza (facoltativa)
Se preferisci addestrare il tuo hardware, puoi trasmettere le metriche alla piattaforma utilizzando la tua chiave API. Funziona come Weights & Biases addestra ovunque, monitora sulla piattaforma.
- Genera una chiave API in
Settings > Profile(Sezione Chiavi API) - Imposta la variabile di ambiente e esegui l'addestramento con un
project/nameformato:
export ULTRALYTICS_API_KEY="ul_your_api_key_here"
yolo train model=yolo26n.pt data=coco.yaml epochs=100 project=username/my-project name=exp1
Formato chiave API
Le chiavi API iniziano con ul_ seguito da 40 caratteri esadecimali (43 caratteri in totale). Le chiavi sono token di accesso completo limitati al tuo spazio di lavoro.
Maggiori informazioni su chiavi API, URI dei set di dati e formazione remota.
Feedback
Apprezziamo il tuo feedback! Utilizza il pulsante di feedback per aiutarci a migliorare la piattaforma.
Privacy del Feedback
Il tuo feedback è privato e visibile solo al team Ultralytics. Lo utilizziamo per dare priorità alle funzionalità e risolvere i problemi.
Serve aiuto?
Se riscontri problemi o hai domande:
- Documentazione: Consulta questa documentazione per guide dettagliate
- Discord: Unisciti alla nostra community Discord per discussioni
- GitHub: Segnala problemi su GitHub
Nota
Quando si segnala un bug, si prega di includere i dettagli del browser e del sistema operativo per aiutarci a diagnosticare il problema.