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#

1. Export từ Label Studio. Mở project của bạn và nhấp vào Export.
2. Chọn format có kèm ảnh. Chọn YOLO with Images rồi nhấp vào Export.
3. Upload lên Platform. Tạo dataset mới từ file ZIP.
4. Train. Chỉnh sửa annotations, train và deploy mà không cần rời workspace.

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.zip

COCO_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:

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.

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ý

FAQ#