Link to this sectionIntegrazione con Label Studio#
Le importazioni dirette da Label Studio stanno arrivando su Ultralytics Platform, in modo che un'esportazione di rilevamento o segmentazione di immagini grezze venga caricata così com'è senza alcun formato da scegliere.
Fino ad allora c'è una scorciatoia che funziona già oggi, poiché l'esportazione YOLO con immagini di Label Studio è un layout che Platform legge, elenco delle classi incluso.
Link to this sectionImporta da Label Studio oggi#
- Esporta da Label Studio. Apri il tuo progetto e clicca su Export.
- Scegli un formato che includa le immagini. Scegli YOLO with Images e clicca su Export.
- Carica su Platform. Crea un nuovo dataset dallo ZIP.
- Allena. Modifica le annotazioni, allena e distribuisci senza lasciare l'area di lavoro.
Le opzioni YOLO e COCO di Label Studio scrivono file di etichette senza le immagini, poiché le tue immagini risiedono normalmente dietro gli URL a cui puntava Label Studio. Il caricamento di uno di quegli archivi su Platform ti offre un dataset senza immagini. Scegli invece la variante con immagini.
Link to this sectionEsporta con l'API#
L'API di esportazione di Label Studio restituisce lo stesso archivio, con il nome del formato in exportType:
curl -X GET "https://<your-label-studio>/api/projects/<project-id>/export?exportType=YOLO_WITH_IMAGES&download_all_tasks=true" \
-H "Authorization: Token <your-legacy-token>" \
-o dataset.zipCOCO_WITH_IMAGES e YOLO_OBB_WITH_IMAGES funzionano allo stesso modo. I token di accesso personali più recenti vengono scambiati con un token di portatore a breve durata prima dell'uso, quindi controlla quale tipo di token emette la tua istanza. I progetti di grandi dimensioni dovrebbero invece utilizzare gli endpoint delle istantanee, che creano l'esportazione come processo in background e la scaricano per ID; l'esempio export_yolo_with_images.py dell'SDK fa esattamente questo.
Un'esportazione YOLO di Label Studio trasporta il suo elenco di classi insieme alle etichette e Platform lo legge:
archive.zip/
├── classes.txt # class names Platform reads first
├── notes.json # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/Carica l'archivio esattamente come lo ha prodotto Label Studio. Platform cerca classes.txt e notes.json nella radice dell'archivio, quindi ri-zippare l'esportazione all'interno di un'altra cartella fa perdere i nomi delle tue etichette e le classi vengono importate come class0, class1 e così via.
Link to this sectionScelta di un formato di esportazione#
Label Studio offre diversi formati di esportazione. Per il rilevamento e la segmentazione delle immagini:
| Formato Label Studio | Funziona | Note |
|---|---|---|
| YOLO with Images | Il migliore | Invia classes.txt e le immagini, quindi un singolo caricamento è sufficiente |
| COCO with Images | Sì | Letto anch'esso; un mix di poligoni e riquadri viene importato come segmento, scartando quelli con solo riquadri |
| YOLO / COCO | No | Solo file di annotazione: il dataset viene importato senza immagini |
| Pascal VOC XML | No | I file di etichette XML non possono essere letti |
Platform non legge le etichette XML di Pascal VOC e un'esportazione VOC fallisce silenziosamente anziché in modo evidente: le immagini vengono importate e le annotazioni no. Scegli invece YOLO with Images o COCO with Images.
Link to this sectionCosa aggiungerà l'integrazione#
La scelta del formato di esportazione corretto è il passaggio che l'integrazione rimuove. Una volta rilasciata, potrai esportare qualsiasi formato di rilevamento e segmentazione delle immagini di Label Studio, caricarlo e Platform mapperà autonomamente le annotazioni sul task YOLO corrispondente.
- Nessun formato da scegliere — le esportazioni di rilevamento e segmentazione delle immagini di Label Studio vengono mappate su un dataset YOLO con i nomi delle etichette preservati
- Un'area di lavoro — l'etichettatura, l'addestramento e la distribuzione smettono di estendersi su strumenti separati e uno script di conversione
- Continua a etichettare — i dataset importati si aprono nell'editor di annotazioni di Platform, inclusa l'etichettatura intelligente basata su SAM
- Allena immediatamente — i dataset sono pronti per l'addestramento su cloud non appena completano l'elaborazione
Le integrazioni Labelbox, Roboflow e Ultralytics HUB funzionano già oggi e Platform importa direttamente i dataset YOLO, COCO e NDJSON di Ultralytics.