Link to this sectionИнтеграция с Label Studio#
Прямой импорт из Label Studio скоро появится в Ultralytics Platform, поэтому экспорт обнаружения объектов или сегментации для исходных изображений будет загружаться как есть без необходимости выбора формата.
До тех пор существует короткий путь, который работает уже сегодня, поскольку экспорт YOLO with Images в Label Studio представляет собой структуру, которую читает Platform, включая список классов.
Link to this sectionИмпорт из Label Studio сегодня#
- Экспорт из Label Studio. Открой свой проект и нажми Export.
- Выбери формат, включающий изображения. Выбери YOLO with Images и нажми Export.
- Загрузка на Platform. Создай новый датасет из ZIP-архива.
- Обучение. Отредактируй аннотации, обучай и развертывай, не покидая рабочее пространство.
Опции YOLO и COCO в Label Studio сохраняют файлы меток без изображений, так как твои изображения обычно находятся по URL-адресам, на которые указывала Label Studio. Загрузка одного из таких архивов на Platform приводит к созданию датасета без изображений. Вместо этого выбери вариант with Images.
Link to this sectionЭкспорт с помощью 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 работают аналогичным образом. Новые персональные токены доступа перед использованием обмениваются на недолговечный токен носителя, поэтому проверь, какой тип токена выдает твой экземпляр. Для больших проектов следует использовать эндпоинты снимков, которые создают экспорт в виде фоновой задачи и скачивают его по ID; пример 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 и так далее.
Link to this sectionВыбор формата экспорта#
Label Studio предлагает несколько форматов экспорта. Для обнаружения объектов и сегментации на изображениях:
| Формат Label Studio | Статус | Примечания |
|---|---|---|
| YOLO with Images | Лучший | Включает classes.txt и изображения, поэтому достаточно одной загрузки |
| COCO with Images | Да | Тоже читается; комбинация полигонов и боксов импортируется как сегмент, а элементы только с боксами отбрасываются |
| YOLO / COCO | Нет | Только файлы аннотаций — датасет импортируется без изображений |
| Pascal VOC XML | Нет | XML-файлы меток не могут быть прочитаны |
Platform не читает метки Pascal VOC XML, и экспорт VOC завершается с ошибкой тихо, а не громко: изображения импортируются, а аннотации — нет. Вместо этого выбери YOLO with Images или COCO with Images.
Link to this sectionЧто добавит интеграция#
Выбор правильного формата экспорта — это шаг, который исключает интеграция. После ее запуска ты сможешь экспортировать любой формат обнаружения и сегментации изображений из Label Studio, загрузить его, и Platform сама сопоставит аннотации с соответствующей задачей YOLO.
- Не нужно выбирать формат — экспорты обнаружения и сегментации изображений из Label Studio сопоставляются с датасетом YOLO с сохранением имен меток
- Единое рабочее пространство — разметка, обучение и развертывание больше не требуют использования разных инструментов и скрипта конвертации
- Продолжай разметку — импортированные датасеты открываются в редакторе аннотаций Platform, включая умную разметку на базе SAM
- Обучай немедленно — датасеты готовы к облачному обучению сразу после завершения обработки
Интеграции с Labelbox, Roboflow и Ultralytics HUB работают уже сегодня, а Platform напрямую импортирует датасеты YOLO, COCO и Ultralytics NDJSON.