Ultralytics YOLO27 :
Get Started
Coming Soon

Intégration de Label Studio#

Les importations directes depuis Label Studio arrivent bientôt dans Ultralytics Platform, pour que tu puisses téléverser tel quel un export brut de détection ou de segmentation d’images, sans avoir à choisir de format.

En attendant, une méthode simple fonctionne dès maintenant : l’export YOLO with Images de Label Studio utilise une structure que Platform peut lire, liste de classes incluse.

Importer depuis Label Studio dès maintenant#

  1. Exporter depuis Label Studio. Ouvre ton projet et clique sur Exporter.
  2. Choisir un format qui inclut les images. Sélectionne YOLO with Images ou YOLOv8 OBB with Images pour les boîtes orientées, puis clique sur Exporter.
  3. Importer dans Platform. Crée un nouveau jeu de données à partir du ZIP.
  4. Entraîner. Modifie les annotations, entraîne et déploie sans quitter l'espace de travail.

Importation de jeux de données Label Studio dans Ultralytics Platform

Les exports YOLO et COCO standard ne contiennent que les annotations

Les options YOLO et COCO de Label Studio créent des fichiers de labels sans les images, car celles-ci sont généralement hébergées aux URL indiquées dans Label Studio. Le téléversement d’une de ces archives dans Platform échoue avec le message indiquant qu’aucune image n’a été trouvée. Choisis plutôt la variante with Images.

Exporter avec l’API#

L’API d’exportation de Label Studio renvoie la même archive, avec le nom du format dans 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.zip

COCO_WITH_IMAGES et YOLO_OBB_WITH_IMAGES fonctionnent de la même manière. Les jetons d’accès personnels plus récents sont échangés contre un jeton bearer de courte durée avant utilisation ; vérifie donc quel type de jeton ton instance émet. Pour les projets volumineux, utilise plutôt les points de terminaison de snapshot, qui créent l’export en tant que tâche d’arrière-plan et le téléchargent par ID ; l’exemple export_yolo_with_images.py du SDK fait exactement cela.

Un export YOLO de Label Studio inclut la liste de classes avec les labels, et Platform la lit :

archive.zip/
├── classes.txt        # class names Platform reads first
├── notes.json         # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/

Platform lit le classes.txt (ou notes.json) le moins imbriqué dans l’archive. Ainsi, les noms de labels sont conservés même si tu décompresses l’export puis le recompresse dans un dossier.

Choisir un format d'exportation#

Label Studio propose plusieurs formats d’export. Pour la détection et la segmentation d’images :

Format Label StudioCompatibilitéRemarques
YOLO with ImagesOptimalInclut classes.txt et les images ; un seul téléversement suffit donc
YOLOv8 OBB with ImagesOuiConserve la rotation des boîtes et est importé comme jeu de données OBB
COCO with ImagesOuiÉgalement pris en charge ; à privilégier si chaque annotation est un polygone à quatre points
YOLO / COCONonFichiers d’annotations uniquement — le téléversement échoue avec le message indiquant qu’aucune image n’a été trouvée
Pascal VOC XMLNonLes fichiers de labels XML ne peuvent pas être lus

Dans un export COCO, chaque annotation doit contenir un bbox pour être lue, les régions de foule ("iscrowd": 1) sont ignorées, et les noms de catégories deviennent tes noms de classes — une archive COCO n’a donc pas besoin de classes.txt pour conserver ses labels.

Pascal VOC est importé sans annotations

Platform ne lit pas les labels Pascal VOC XML, et un export VOC échoue discrètement : les images sont importées, mais pas les boîtes, et un export contenant au moins cinq images récupère également une classe unique nommée images. Choisis plutôt YOLO with Images ou COCO with Images.

Éléments conservés#

Platform détermine la tâche YOLO à partir des labels de l’export :

Labels Label StudioJeu de données Platform
RectangleLabelsDétection, ou OBB pour un export YOLOv8 OBB
PolygonLabelsSegmentation, ou OBB pour un export YOLO lorsque chaque polygone comporte quatre points
RectangleLabels + PolygonLabelsSegmentation — les boîtes restent modifiables, mais seules les formes polygonales sont utilisées pour l’entraînement
KeyPointLabels à l’intérieur d’un rectanglePose
ChoicesNon pris en charge par les formats YOLO ou COCO de Label Studio ; les images sont donc importées sans labels
  • Boîtes orientées — les exports YOLO et COCO suppriment la rotation ; utilise YOLOv8 OBB with Images pour la conserver.
  • Points clés — l’export YOLO de Label Studio inclut un point clé uniquement lorsque son <Label> dans KeyPointLabels comporte un attribut model_index et que le point a été placé à l’intérieur d’un rectangle ; sinon, l’export ne contient que les boîtes et le jeu de données est importé comme tâche de détection.
  • Polygones à quatre points — dans les fichiers YOLO, un polygone à exactement quatre points ressemble à une boîte orientée ; un export YOLO dont chaque label est un polygone à quatre points est donc importé comme OBB. Utilise COCO with Images pour ces projets.

Ce que l'intégration apportera#

Choisir le bon format d’export est l’étape que l’intégration supprimera. Une fois celle-ci disponible, tu pourras exporter n’importe quel format de détection ou de segmentation d’images de Label Studio, le téléverser, et Platform associera automatiquement les annotations à la tâche YOLO correspondante.

  • Aucun format à choisir — les exports de détection et de segmentation d’images de Label Studio sont associés à un jeu de données YOLO, avec conservation des noms de labels
  • Un seul espace de travail — l'annotation, l'entraînement et le déploiement ne nécessitent plus plusieurs outils et un script de conversion
  • Continue à annoter — les jeux de données importés s'ouvrent dans l'éditeur d'annotations de Platform, qui inclut l'annotation intelligente optimisée par SAM
  • Entraîne immédiatement — les jeux de données sont prêts pour l'entraînement dans le cloud dès la fin du traitement
Disponible dès maintenant

Les intégrations Labelbox et Roboflow sont disponibles dès maintenant, et Platform importe directement les jeux de données YOLO, COCO, JSON LabelMe et NDJSON Ultralytics ou Labelbox.

FAQ#

  • Choisis YOLO with Images pour que l’archive contienne classes.txt et les images. COCO with Images est également importé. Les options YOLO et COCO standard ne créent que des fichiers de labels, et Pascal VOC XML n’est pas pris en charge.

  • L’export standard YOLO ou COCO a été utilisé. Ces archives ne contiennent pas les images, car Label Studio les héberge généralement à des URL. Réexporte les données avec la variante with Images.

  • L’archive ne contient pas de classes.txt ou notes.json, généralement parce qu’elle a été recréée uniquement à partir des dossiers images/ et labels/. Téléverse le ZIP exporté par Label Studio, qui contient les deux fichiers.

  • Oui. Appelle le point de terminaison d’exportation avec exportType=YOLO_WITH_IMAGES, ou avec COCO_WITH_IMAGES et YOLO_OBB_WITH_IMAGES. Pour les projets volumineux, utilise les points de terminaison de snapshot, qui créent l’export en tant que tâche d’arrière-plan.

Contributeurs
GLglenn-jocher4RAraimbekovm3SEsergiuwaxmann1

Commentaires