Ultralytics YOLO27:

Интеграция с Label Studio#

Импорт напрямую из Label Studio скоро появится на Ultralytics Platform: экспорт изображений для детекции или сегментации можно будет загрузить как есть, без выбора формата.

А пока можно воспользоваться простым способом, который работает уже сейчас: Platform поддерживает экспорт Label Studio в формате YOLO with Images, включая список классов.

Импорт из Label Studio уже сегодня#

  1. Экспортируй данные из Label Studio. Открой проект и нажми Export.
  2. Выбери формат, который включает изображения. Выбери YOLO with Images и нажми Export.
  3. Загрузи данные на Platform. Создай новый датасет из ZIP-архива.
  4. Обучай модель. Редактируй аннотации, обучай и развёртывай, не покидая рабочее пространство.

Импорт датасета Label Studio в Ultralytics Platform

Обычные форматы YOLO и COCO экспортируют только аннотации

Варианты Label Studio YOLO и COCO записывают файлы с разметкой без изображений, потому что обычно изображения размещены по URL, указанным в Label Studio. Если загрузить один из таких архивов на Platform, датасет будет без изображений. Вместо этого выбери вариант with Images.

Экспорт через API#

API экспорта Label Studio возвращает такой же архив, а название формата указывается в 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 и YOLO_OBB_WITH_IMAGES работают одинаково. Перед использованием более новые персональные токены доступа обмениваются на краткоживущий токен bearer, поэтому проверь, какой тип токена выдает твой экземпляр. Для крупных проектов используй конечные точки снимков: они создают экспорт как фоновую задачу и позволяют скачать его по ID. Именно так работает пример export_yolo_with_images.py из SDK.

Экспорт Label Studio в формате YOLO содержит список классов вместе с разметкой, и Platform считывает его:

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

Загрузи архив точно в том виде, в каком его создала Label Studio. Platform ищет classes.txt и notes.json в корне архива, поэтому, если перепаковать экспорт во вложенную папку, названия меток потеряются, а классы импортируются как class0, class1 и так далее.

Выбор формата экспорта#

Label Studio предлагает несколько форматов экспорта. Для детекции и сегментации изображений:

Формат Label StudioПоддержкаПримечания
YOLO with ImagesЛучший вариантВключает classes.txt и изображения, поэтому достаточно загрузить один архив
COCO with ImagesДаТоже поддерживается; при сочетании полигонов и рамок импортируется сегментация, а разметка только рамками отбрасывается
YOLO / COCOНетТолько файлы с аннотациями — датасет импортируется без изображений
Pascal VOC XMLНетФайлы разметки XML не поддерживаются

Чтобы прочитать экспорт COCO, каждая аннотация должна содержать bbox; области скопления объектов ("iscrowd": 1) пропускаются, а названия категорий становятся названиями классов — поэтому архиву COCO не нужен classes.txt, чтобы сохранить названия меток.

Импорт Pascal VOC без аннотаций

Platform не считывает разметку Pascal VOC XML, а экспорт VOC завершается без явной ошибки: изображения импортируются, а аннотации — нет. Вместо этого выбери YOLO with Images или COCO with Images.

Что добавит интеграция#

Интеграция избавит от необходимости выбирать подходящий формат экспорта. Когда она появится, ты сможешь экспортировать данные в любом формате Label Studio для детекции и сегментации изображений, загрузить их, а Platform сама сопоставит аннотации с подходящей задачей YOLO.

  • Выбирать формат не нужно — экспорт Label Studio для детекции и сегментации изображений преобразуется в датасет YOLO с сохранением названий меток
  • Единое рабочее пространство — разметка, обучение и развёртывание больше не будут требовать переключения между разными инструментами и использования скрипта преобразования
  • Продолжай разметку — импортированные датасеты открываются в редакторе аннотаций Platform, в том числе с интеллектуальной разметкой на базе SAM
  • Сразу приступай к обучению — как только обработка завершится, датасеты будут готовы к обучению в облаке
Доступно уже сейчас

Интеграции с Labelbox и Roboflow уже работают, а Platform напрямую импортирует датасеты YOLO, COCO и Ultralytics NDJSON.

Часто задаваемые вопросы#

  • Выбери YOLO with Images, чтобы архив содержал classes.txt и изображения. Формат COCO with Images тоже поддерживается. Обычные варианты YOLO и COCO включают только файлы с разметкой, а Pascal VOC XML не поддерживается.

  • Ты использовал обычный экспорт YOLO или COCO. В таких архивах нет изображений, потому что Label Studio обычно предоставляет их по URL. Повтори экспорт, выбрав вариант with Images.

  • Platform считывает classes.txt (или notes.json, если первый вариант недоступен) из корня архива. Загрузи экспорт точно в том виде, в каком его создала Label Studio; если перепаковать его во вложенную папку, список классов не будет виден.

  • Да. Вызови конечную точку экспорта с exportType=YOLO_WITH_IMAGES или с COCO_WITH_IMAGES и YOLO_OBB_WITH_IMAGES. Для крупных проектов используй конечные точки снимков: они создают экспорт как фоновую задачу.

Комментарии