Link to this sectionИнтеграция с Labelbox#

Ultralytics Platform читает экспорт NDJSON из Labelbox напрямую. Не нужно вставлять ключи, поддерживать соединение или сценарии конвертации: экспортируй из Labelbox, загружай файл, и твои разметки появятся как обычный датасет на платформе.

Link to this sectionИмпорт из Labelbox#

1. Экспорт из Labelbox. Открой проект разметки или каталог, который хочешь перенести, и перейди на вкладку Data Rows. Выбери All, нажми Export data, укажи нужные поля и подтверди. Экспортируешь из каталога, а не из проекта? Включи параметр Export labels from project и выбери проект, иначе файл придет вообще без аннотаций.
2. Скачай файл. Labelbox выполняет экспорт как фоновую задачу. Следи за ней в уведомлениях и по завершении нажми Download, чтобы сохранить файл .ndjson.
3. Загрузка на платформу. Создай новый датасет и загрузи файл .ndjson либо вставь прямую ссылку на него. Также можно начать с раздела Settings > Integrations > Labelbox.
4. Обучение. После завершения обработки отредактируй аннотации и запусти обучение точно так же, как для любого другого датасета платформы.

В отличие от CVAT и Label Studio, здесь не нужно выбирать формат — поддерживается собственный экспорт Labelbox.

Link to this sectionЭкспорт с помощью SDK#

Labelbox также предлагает задачу экспорта в своем Python SDK, что проще для повторяемого конвейера. Передавай задачу потоком и записывай по одному объекту JSON на строку:

import json

import labelbox

client = labelbox.Client(api_key="YOUR_LABELBOX_API_KEY")
export_task = labelbox.ExportTask.get_task(client, "YOUR_EXPORT_TASK_ID")
export_task.wait_till_done()  # streaming a task that isn't COMPLETE raises

with open("dataset.ndjson", "w") as f:
    f.writelines(json.dumps(data_row.json) + "\n" for data_row in export_task.get_buffered_stream())

Link to this sectionЧто импортируется#

Платформа самостоятельно распознает формат Labelbox и сопоставляет ограничивающие рамки и полигоны с соответствующим типом задач YOLO:

Поле name каждого объекта становится именем класса — то есть аннотация "name": "Dog" импортируется как класс Dog, а не его строчное значение value, — а координаты пикселей нормализуются относительно размеров media_attributes в экспорте. Экспорт каталога без аннотаций импортируется как неразмеченный набор изображений, готовый к разметке в редакторе аннотаций платформы.

Одна строка данных выглядит следующим образом, обрезанная до полей, которые читает платформа:

{
    "data_row": {
        "external_id": "000000000307.jpg",
        "row_data": "https://storage.labelbox.com/...?Expires=...&Signature=..."
    },
    "media_attributes": { "height": 480, "width": 640, "mime_type": "image/jpeg" },
    "projects": {
        "<project-id>": {
            "labels": [
                {
                    "annotations": {
                        "objects": [
                            {
                                "name": "Dog",
                                "annotation_kind": "ImageBoundingBox",
                                "bounding_box": { "top": 200.0, "left": 407.0, "height": 172.0, "width": 176.0 }
                            }
                        ]
                    }
                }
            ]
        }
    }
}

Все остальное в экспорте — embeddings, metadata_fields, attachments, project_details — игнорируется. Эмбеддинги стоит отключать при экспорте: в тестовом экспорте они занимали около четырех пятых файла, в то время как на поля, которые читает платформа, приходилась лишь пятая часть.