Tích hợp Label Studio#
Tính năng import trực tiếp từ Label Studio sắp có trên Ultralytics Platform, cho phép tải lên nguyên trạng bản export phát hiện hoặc phân đoạn ảnh thô mà không cần chọn format.
Trong thời gian chờ đợi, hiện đã có một quy trình ngắn có thể sử dụng ngay, vì tùy chọn export YOLO with Images của Label Studio tạo ra layout mà Platform có thể đọc, bao gồm cả danh sách class.
Import từ Label Studio ngay hôm nay#
- Export từ Label Studio. Mở project của bạn và nhấp vào Export.
- Chọn format có kèm ảnh. Chọn YOLO with Images rồi nhấp vào Export.
- Upload lên Platform. Tạo dataset mới từ file ZIP.
- Train. Chỉnh sửa annotations, train và deploy mà không cần rời workspace.
Các tùy chọn YOLO và COCO của Label Studio ghi các file label mà không kèm ảnh, vì thông thường ảnh của bạn nằm sau các URL mà Label Studio được trỏ tới. Tải một trong các archive đó lên Platform sẽ tạo dataset không có ảnh. Thay vào đó, hãy chọn biến thể with Images.
Export bằng API#
export API của Label Studio trả về cùng một archive, với tên format nằm trong 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 và YOLO_OBB_WITH_IMAGES hoạt động theo cùng một cách. Các personal access token mới hơn được đổi thành bearer token có thời hạn ngắn trước khi sử dụng, vì vậy hãy kiểm tra instance của bạn cấp loại token nào. Các project lớn nên sử dụng snapshot endpoint thay thế; các endpoint này tạo export dưới dạng background job và tải xuống theo ID. Ví dụ export_yolo_with_images.py trong SDK thực hiện chính xác điều đó.
Export YOLO của Label Studio chứa danh sách class cùng với các label, và Platform sẽ đọc danh sách này:
archive.zip/
├── classes.txt # class names Platform reads first
├── notes.json # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/Tải archive lên đúng nguyên trạng như Label Studio đã tạo. Platform tìm classes.txt và notes.json ở thư mục gốc của archive, vì vậy việc nén lại export bên trong một thư mục khác sẽ làm mất tên label và các class được import thành class0, class1, v.v.
Chọn Format Export#
Label Studio cung cấp nhiều format export. Đối với phát hiện và phân đoạn ảnh:
| Format Label Studio | Hoạt động | Ghi chú |
|---|---|---|
| YOLO with Images | Tốt nhất | Bao gồm classes.txt và ảnh, vì vậy chỉ cần tải lên một lần |
| COCO with Images | Có | Cũng được đọc; hỗn hợp polygon và box được import dưới dạng segment, còn các đối tượng chỉ có box sẽ bị loại bỏ |
| YOLO / COCO | Không | Chỉ có file annotation — dataset được import mà không có ảnh |
| Pascal VOC XML | Không | Không thể đọc các file label XML |
Trong một export COCO, mọi annotation phải chứa bbox thì mới được đọc, các vùng crowd ("iscrowd": 1) sẽ bị bỏ qua, và tên category trở thành tên class của bạn — vì vậy archive COCO không cần classes.txt để giữ lại các label.
Platform không đọc các label Pascal VOC XML, và export VOC sẽ âm thầm thất bại thay vì báo lỗi rõ ràng: ảnh được import còn annotation thì không. Thay vào đó, hãy chọn YOLO with Images hoặc COCO with Images.
Tích hợp sẽ bổ sung gì#
Việc chọn đúng format export là bước mà integration này loại bỏ. Khi tính năng được phát hành, bạn sẽ có thể export bất kỳ format phát hiện và phân đoạn ảnh nào của Label Studio, tải lên, và Platform sẽ tự ánh xạ annotation với YOLO task tương ứng.
- Không cần chọn format — các export phát hiện và phân đoạn ảnh của Label Studio được ánh xạ thành dataset YOLO với tên label được giữ nguyên
- Một workspace — labeling, training và deployment không còn phải trải rộng trên các tool riêng biệt cùng một script chuyển đổi
- Tiếp tục annotation — các dataset được import sẽ mở trong annotation editor của Platform, bao gồm cả tính năng smart annotation được hỗ trợ bởi SAM
- Train ngay lập tức — dataset sẵn sàng cho cloud training ngay khi hoàn tất xử lý