Интеграция с Label Studio#
Прямой импорт из Label Studio скоро появится в Ultralytics Platform, чтобы необработанный экспорт изображений для обнаружения объектов или сегментации загружался как есть, без выбора формата.
А пока уже сегодня можно воспользоваться коротким обходным путём: экспорт Label Studio YOLO with Images имеет структуру, которую Platform распознаёт, включая список классов.
Импорт из Label Studio уже сегодня#
- Экспортируй данные из Label Studio. Открой проект и нажми Экспортировать.
- Выбери формат, включающий изображения. Выбери YOLO with Images и нажми Экспортировать.
- Загрузи в Platform. Создай новый датасет из ZIP-архива.
- Обучи модель. Отредактируй аннотации, обучи модель и разверни её, не покидая рабочего пространства.
Параметры YOLO и COCO в Label Studio записывают файлы с метками без изображений, поскольку обычно изображения находятся по URL, на который был настроен Label Studio. Если загрузить один из таких архивов в Platform, получится датасет без изображений. Вместо этого выбери вариант с изображениями.
Экспорт через 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 работают одинаково. Перед использованием новые токены персонального доступа обмениваются на токен типа bearer с коротким сроком действия, поэтому проверь, какой тип токена выдаёт твой экземпляр. Для крупных проектов вместо этого используй конечные точки snapshot: они создают экспорт как фоновую задачу и загружают его по идентификатору; пример 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
- Обучай сразу — датасеты готовы к обучению в облаке, как только их обработка завершится
Часто задаваемые вопросы#
Выбери YOLO with Images, чтобы архив содержал
classes.txtи изображения. COCO with Images также поддерживается для импорта. Обычные опции YOLO и COCO записывают только файлы меток, а Pascal VOC XML не читается.Был использован обычный экспорт
YOLOилиCOCO. Эти архивы не содержат изображения, потому что Label Studio обычно передает их по URL. Повтори экспорт с вариантом with Images.Платформа считывает
classes.txt(илиnotes.jsonв качестве резервного варианта) из корневого каталога архива. Загружай экспорт в том виде, в каком его создала Label Studio; повторная упаковка в архив внутри другой папки скроет список классов.Да. Вызови конечную точку экспорта с
exportType=YOLO_WITH_IMAGESлибоCOCO_WITH_IMAGESиYOLO_OBB_WITH_IMAGES. Для больших проектов следует использовать конечные точки снимков, которые создают экспорт в качестве фоновой задачи.