Label Studio 연동#
직접 Label Studio 가져오기 기능이 Ultralytics Platform에 도입될 예정이므로, 원본 이미지 감지 또는 분할 내보내기가 별도의 포맷 선택 없이 그대로 업로드됩니다.
그 전까지는 오늘날 바로 작동하는 간단한 우회 방법이 있습니다. Label Studio의 YOLO with Images 내보내기는 Platform이 클래스 목록을 포함하여 읽을 수 있는 레이아웃이기 때문입니다.
지금 바로 Label Studio에서 가져오기#
- Label Studio에서 내보내기. 프로젝트를 열고 Export를 클릭합니다.
- 이미지가 포함된 포맷을 선택하세요. **YOLO with Images**를 선택하고 Export를 클릭합니다.
- Platform에 업로드합니다. ZIP 파일에서 새 데이터셋을 생성합니다.
- 학습합니다. 워크스페이스를 떠나지 않고 주석을 편집하고, 학습하며, 배포합니다.
Label Studio의 YOLO 및 COCO 옵션은 이미지를 제외한 레이블 파일만 기록하는데, 이는 이미지들이 대개 Label Studio가 가리키던 URL 뒤에 있기 때문입니다. 그러한 아카이브 중 하나를 Platform에 업로드하면 이미지가 없는 데이터셋이 생성됩니다. 대신 with Images 변형을 선택하세요.
API를 사용한 내보내기#
Label Studio의 export API는 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은 동일한 방식으로 작동합니다. 최신 personal access tokens은 사용 전에 수명이 짧은 bearer token으로 교환되므로 인스턴스에서 발급하는 토큰 유형을 확인하세요. 대규모 프로젝트의 경우 백그라운드 작업으로 내보내기를 생성하고 ID로 다운로드하는 snapshot endpoints를 대신 사용해야 합니다. SDK의 export_yolo_with_images.py 예제가 정확히 그 작업을 수행합니다.
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는 several export formats을 제공합니다. 이미지 감지 및 분할의 경우:
| 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 task에 직접 매핑합니다.
- 포맷 선택 불필요 — Label Studio의 이미지 검출 및 세그멘테이션 내보내기가 라벨 이름이 보존된 YOLO 데이터셋으로 매핑됩니다
- 단일 워크스페이스 — 라벨링, 학습, 배포가 별도의 도구와 변환 스크립트에 걸쳐 분산되지 않습니다
- 계속 주석 달기 — 가져온 데이터셋은 SAM 기반 스마트 주석 기능을 포함하여 Platform의 주석 편집기에서 열립니다.
- 즉시 학습 — 데이터셋은 처리가 완료되는 즉시 클라우드 학습을 수행할 준비가 됩니다.