Интеграция с Label Studio#
Прямой импорт из Label Studio скоро появится на Ultralytics Platform, благодаря чему экспорт сырых данных для детекции или сегментации изображений будет загружаться как есть без необходимости выбирать формат.
До тех пор существует короткий путь, который работает уже сегодня, поскольку экспорт YOLO with Images в Label Studio представляет собой структуру, которую читает Platform, включая список классов.
Импорт из Label Studio сегодня#
- Экспорт из Label Studio. Открой свой проект и нажми Export.
- Выбери формат, включающий изображения. Выбери YOLO with Images и нажми Export.
- Загрузи в Platform. Создай новый датасет из ZIP-файла.
- Обучай. Редактируй аннотации, обучай и развертывай, не покидая рабочее пространство.
Варианты YOLO и COCO в Label Studio записывают файлы разметки без изображений, так как твои изображения обычно хранятся по ссылкам, на которые указывает 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.zipCOCO_WITH_IMAGES и YOLO_OBB_WITH_IMAGES работают одинаково. Новые персональные токены доступа перед использованием обмениваются на недолговечный токен носителя, поэтому проверь, какой тип токена выдает твой экземпляр. Большим проектам вместо этого следует использовать эндпоинты сниппетов, которые создают экспорт как фоновую задачу и скачивают его по идентификатору; пример export_yolo_with_images.py из SDK делает именно это.
Экспорт YOLO из Label Studio содержит список классов вместе с метками, и 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, чтобы сохранить свои метки.
Platform не читает метки Pascal VOC XML, и экспорт VOC завершается с ошибкой тихо, а не громко: изображения импортируются, а аннотации — нет. Вместо этого выбери YOLO with Images или COCO with Images.
Что добавит интеграция#
Выбор правильного формата экспорта — это шаг, который интеграция убирает. После ее выпуска ты сможешь экспортировать любой из форматов детекции и сегментации изображений Label Studio, загрузить его, и Platform сама сопоставит аннотации с подходящей задачей YOLO.
- Не нужно выбирать формат — экспорты обнаружения и сегментации изображений из Label Studio сопоставляются с датасетом YOLO с сохранением имен меток
- Единое рабочее пространство — разметка, обучение и развертывание больше не требуют использования разных инструментов и скрипта конвертации
- Продолжай разметку — импортированные датасеты открываются в редакторе аннотаций Platform, включая умную разметку на базе SAM
- Обучай немедленно — датасеты готовы к облачному обучению сразу после завершения обработки