Tích hợp Label Studio#

Tính năng nhập trực tiếp từ Label Studio sẽ sớm có trên Ultralytics Platform, cho phép tải nguyên trạng bản xuất phát hiện ảnh hoặc segmentation mà không cần chọn định dạng.

Trong thời gian chờ, bạn có thể dùng quy trình ngắn gọn hiện có, vì bản xuất YOLO with Images của Label Studio có cấu trúc mà Platform đọc được, bao gồm cả danh sách class.

Nhập từ Label Studio ngay hôm nay#

1. Xuất từ Label Studio. Mở project và nhấp vào Export.
2. Chọn định dạng có kèm ảnh. Chọn YOLO with Images hoặc YOLOv8 OBB with Images nếu cần box xoay, rồi nhấp vào Export.
3. Tải lên Platform. Tạo dataset mới từ tệp ZIP.
4. Huấn luyện. Chỉnh sửa annotation, huấn luyện và triển khai mà không cần rời workspace.

Xuất bằng API#

API xuất dữ liệu của Label Studio trả về cùng archive, với tên định dạng 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 như nhau. Token truy cập cá nhân 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 loại token mà instance của bạn cấp. Với project lớn, hãy dùng các endpoint snapshot; các endpoint này tạo bản xuất dưới dạng background job và tải xuống bằng ID. Ví dụ export_yolo_with_images.py trong SDK thực hiện đúng quy trình đó.

Bản xuất YOLO của Label Studio chứa danh sách class cùng với nhãn và Platform có thể đọ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/

Platform đọc file classes.txt (hoặc notes.json) nằm ở cấp nông nhất trong archive, vì vậy tên nhãn vẫn được giữ nguyên nếu bạn giải nén bản xuất rồi nén lại bên trong một thư mục.

Chọn định dạng xuất#

Label Studio cung cấp nhiều định dạng xuất. Đối với phát hiện ảnh và segmentation:

Trong bản xuất COCO, mỗi annotation phải có bbox thì mới được đọc; các vùng crowd ("iscrowd": 1) sẽ bị bỏ qua; tên category sẽ trở thành tên class của bạn — vì vậy archive COCO không cần classes.txt để giữ lại nhãn.

Những gì được giữ lại#

Platform xác định tác vụ YOLO dựa trên nhãn trong bản xuất:

• Box xoay — bản xuất YOLO và COCO loại bỏ góc xoay; hãy dùng YOLOv8 OBB with Images để giữ lại góc xoay.
• Keypoint — bản xuất YOLO của Label Studio chỉ bao gồm keypoint khi <Label> của keypoint đó trong KeyPointLabels có thuộc tính model_index và điểm được vẽ bên trong hình chữ nhật; nếu không, bản xuất chỉ chứa box và dataset được nhập thành detect.
• Polygon bốn điểm — trong file YOLO, polygon có đúng bốn điểm trông giống hệt box định hướng, vì vậy bản xuất YOLO trong đó mọi nhãn đều là polygon bốn điểm sẽ được nhập thành OBB. Hãy dùng COCO with Images cho các project đó.

Tích hợp sẽ bổ sung những gì#

Chọn đúng định dạng xuất là bước mà tích hợp sẽ loại bỏ. Khi tính năng ra mắt, bạn sẽ có thể xuất bất kỳ định dạng phát hiện ảnh và segmentation nào của Label Studio rồi tải lên; Platform sẽ tự ánh xạ annotation sang tác vụ YOLO tương ứng.

• Không cần chọn định dạng — các bản xuất phát hiện ảnh và segmentation của Label Studio được ánh xạ sang dataset YOLO và giữ nguyên tên nhãn
• Một workspace duy nhất — việc gắn nhãn, huấn luyện và triển khai không còn phải thực hiện trên các công cụ riêng biệt và qua script chuyển đổi
• Tiếp tục tạo annotation — các dataset đã nhập sẽ mở trong trình chỉnh sửa annotation của Platform, bao gồm tính năng annotation thông minh tích hợp SAM
• Huấn luyện ngay — dataset sẵn sàng cho huấn luyện trên đám mây ngay khi xử lý xong

Câu hỏi thường gặp#