Ultralytics YOLO27:
Get Started
Coming Soon

Integración con Label Studio#

Pronto podrás importar directamente desde Label Studio a Ultralytics Platform, de modo que podrás subir tal cual una exportación de detección o segmentación de imágenes sin tener que elegir un formato.

Hasta entonces, puedes seguir un proceso sencillo que ya funciona: la exportación YOLO with Images de Label Studio tiene una estructura que Platform puede leer e incluye la lista de clases.

Importar desde Label Studio ahora#

  1. Exporta desde Label Studio. Abre el proyecto y haz clic en Exportar.
  2. Elige un formato que incluya las imágenes. Selecciona YOLO with Images o YOLOv8 OBB with Images para las cajas giradas y haz clic en Exportar.
  3. Súbelo a Platform. Crea un conjunto de datos nuevo a partir del ZIP.
  4. Entrena. Edita las anotaciones, entrena y despliega sin salir del espacio de trabajo.

Importación de conjuntos de datos de Label Studio en Ultralytics Platform

Las exportaciones YOLO y COCO estándar solo incluyen anotaciones

Las opciones YOLO y COCO de Label Studio escriben archivos de etiquetas sin las imágenes, porque normalmente estas se encuentran en las URL que se proporcionaron a Label Studio. Si subes uno de esos archivos a Platform, la carga falla porque no se encuentran imágenes. Elige en su lugar la variante with Images.

Exportar con la API#

La API de exportación de Label Studio devuelve el mismo archivo e incluye el nombre del formato en 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 y YOLO_OBB_WITH_IMAGES funcionan del mismo modo. Los tokens de acceso personal más recientes se intercambian por un token de portador de corta duración antes de usarse, así que comprueba qué tipo de token emite tu instancia. Para proyectos grandes, usa los endpoints de instantáneas, que generan la exportación como una tarea en segundo plano y la descargan por ID; el ejemplo export_yolo_with_images.py del SDK hace exactamente eso.

Una exportación YOLO de Label Studio incluye la lista de clases junto a las etiquetas, y Platform la lee:

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

Platform lee el classes.txt (o notes.json) más superficial del archivo, así que los nombres de las etiquetas también se conservan si descomprimes una exportación y vuelves a comprimirla dentro de una carpeta.

Cómo elegir un formato de exportación#

Label Studio ofrece varios formatos de exportación. Para la detección y segmentación de imágenes:

Formato de Label StudioCompatibilidadNotas
YOLO with ImagesEl mejorIncluye classes.txt y las imágenes, así que basta con subir un único archivo
YOLOv8 OBB with ImagesSíConserva la rotación de las cajas y se importa como un conjunto de datos OBB
COCO with ImagesSíTambién se puede leer; es la mejor opción si cada anotación es un polígono de cuatro puntos
YOLO / COCONoSolo archivos de anotaciones: la carga falla porque no se encuentran imágenes
Pascal VOC XMLNoNo se pueden leer los archivos de etiquetas XML

En una exportación COCO, todas las anotaciones deben incluir un bbox para poder leerse; se omiten las regiones de objetos multitudinarios ("iscrowd": 1) y los nombres de las categorías se convierten en nombres de clases, por lo que un archivo COCO no necesita classes.txt para conservar las etiquetas.

Pascal VOC se importa sin anotaciones

Platform no lee las etiquetas XML de Pascal VOC y una exportación VOC falla silenciosamente: se importan las imágenes, pero no las cajas. Además, una exportación de cinco imágenes o más incorpora una única clase llamada images. Elige en su lugar YOLO with Images o COCO with Images.

Qué se conserva#

Platform determina la tarea YOLO a partir de las etiquetas de la exportación:

Etiquetas de Label StudioConjunto de datos de Platform
RectangleLabelsDetect o OBB si se trata de una exportación YOLOv8 OBB
PolygonLabelsSegment o OBB si se trata de una exportación YOLO en la que todos los polígonos tienen cuatro puntos
RectangleLabels + PolygonLabelsSegment: las cajas se pueden seguir editando, pero solo se utilizan los polígonos para el entrenamiento
KeyPointLabels dentro de un rectánguloPose
ChoicesLas exportaciones YOLO o COCO de Label Studio no las incluyen, por lo que las imágenes se importan sin etiquetas
  • Cajas giradas — las exportaciones YOLO y COCO descartan la rotación; usa YOLOv8 OBB with Images para conservarla.
  • Puntos clave — la exportación YOLO de Label Studio incluye un punto clave solo cuando su <Label> en KeyPointLabels tiene un atributo model_index y el punto se ha dibujado dentro de un rectángulo; de lo contrario, la exportación solo contiene las cajas y el conjunto de datos se importa como detect.
  • Polígonos de cuatro puntos — en los archivos YOLO, un polígono de exactamente cuatro puntos tiene el mismo aspecto que una caja orientada, por lo que una exportación YOLO en la que todas las etiquetas sean polígonos de cuatro puntos se importa como OBB. Para esos proyectos, usa COCO with Images.

Qué aportará la integración#

Elegir el formato de exportación adecuado es el paso que elimina la integración. Cuando esté disponible, podrás exportar cualquiera de los formatos de detección y segmentación de imágenes de Label Studio, subirlo y Platform asignará las anotaciones a la tarea YOLO correspondiente.

  • No tendrás que elegir formato — las exportaciones de detección y segmentación de imágenes de Label Studio se asignan a un conjunto de datos YOLO y conservan los nombres de las etiquetas
  • Un solo espacio de trabajo — el etiquetado, el entrenamiento y el despliegue dejan de repartirse entre distintas herramientas y un script de conversión
  • Sigue anotando — los conjuntos de datos importados se abren en el editor de anotaciones de Platform, que incluye anotación inteligente con SAM
  • Entrena de inmediato — los conjuntos de datos están listos para el entrenamiento en la nube en cuanto termina su procesamiento
Disponible ahora

Las integraciones con Labelbox y Roboflow ya funcionan, y Platform importa directamente conjuntos de datos YOLO, COCO, JSON de LabelMe y Ultralytics o Labelbox NDJSON.

Preguntas frecuentes#

  • Elige YOLO with Images para que el archivo incluya classes.txt y las imágenes. También se puede importar COCO with Images. Las opciones YOLO y COCO estándar solo escriben archivos de etiquetas, y no se leen los archivos XML de Pascal VOC.

  • Se ha usado la exportación estándar YOLO o COCO. Esos archivos no incluyen las imágenes porque Label Studio normalmente las sirve desde URL. Vuelve a exportar con la variante with Images.

  • El archivo no contiene classes.txt ni notes.json, normalmente porque se ha vuelto a crear solo a partir de las carpetas images/ y labels/. Sube el ZIP exportado por Label Studio, que incluye ambos archivos.

  • Sí. Llama al endpoint de exportación con exportType=YOLO_WITH_IMAGES o con COCO_WITH_IMAGES y YOLO_OBB_WITH_IMAGES. Para proyectos grandes, usa los endpoints de instantáneas, que generan la exportación como una tarea en segundo plano.

Colaboradores
GLglenn-jocher4RAraimbekovm3SEsergiuwaxmann1

Comentarios