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

Варианты 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.zipCOCO_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, чтобы сохранить названия меток.
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.Platform считывает
classes.txt(илиnotes.json, если первый вариант недоступен) из корня архива. Загрузи экспорт точно в том виде, в каком его создала Label Studio; если перепаковать его во вложенную папку, список классов не будет виден.Да. Вызови конечную точку экспорта с
exportType=YOLO_WITH_IMAGESили сCOCO_WITH_IMAGESиYOLO_OBB_WITH_IMAGES. Для крупных проектов используй конечные точки снимков: они создают экспорт как фоновую задачу.