Редактор аннотаций#
Ultralytics Platform включает редактор разметки для разметки изображений с помощью ограничивающих прямоугольников, полигонов, ключевых точек, ориентированных боксов и классификаций. Редактор поддерживает ручное рисование, интеллектуальную разметку на базе SAM и предсказания от совместимых моделей YOLO.

graph TB
subgraph Draw["Draw Mode"]
A[Box]:::start & B[Polygon]:::start & C[Classify]:::start & D[Keypoint]:::start & E[OBB]:::start
end
subgraph AI["AI-Assisted"]
F[SAM Smart]:::start
G[YOLO Predict]:::start
end
Draw --> H[Save Labels]:::out
AI --> H
classDef start fill:#4CAF50,color:#fff
classDef out fill:#9C27B0,color:#fffПоддерживаемые типы задач#
Редактор аннотаций поддерживает все 6 типов задач YOLO:
| Задача | Инструмент | Формат аннотации |
|---|---|---|
| Detect | Прямоугольник | Ограничивающие рамки (x, y, ширина, высота) |
| Segment | Полигон | Пиксельно-точные маски (вершины полигона) |
| Semantic | Полигон | Региональные маски для каждого класса (вершины полигона) |
| Classify | Селектор классов | Метки уровня изображения |
| Pose | Ключевая точка | Шаблоны скелета (Человек, Рука, Лицо, Собака, Коробка, пользовательские) |
| OBB | Ориентированная рамка | Повернутые ограничивающие рамки (4 угла) |
Все 6 типов аннотаций сохраняются вместе для каждого изображения. Ты можешь переключать активный тип задачи для набора данных, не теряя существующие аннотации — они сохраняются и появляются снова, когда ты переключаешься обратно.
Детали задачи#
Детекция объектов
Что это делает: Идентифицирует объекты и их расположение с помощью выровненных по осям ограничивающих рамок.
Формат метки: class_id center_x center_y width height (все нормализовано в диапазоне 0-1)
Пример: 0 0.5 0.5 0.2 0.3 — Класс 0 с центром в (50%, 50%), шириной 20% и высотой 30%
Варианты использования: Инвентаризация, мониторинг дорожного движения, обнаружение дикой природы, системы безопасности
Сегментация экземпляров
Что это делает: Создает пиксельно-точные маски для каждого экземпляра объекта.
Формат метки: class_id x1 y1 x2 y2 x3 y3 ... (вершины полигона, нормализованные в 0-1)
Пример: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Четырехугольная маска
Варианты использования: Медицинская визуализация, автономные транспортные средства, редактирование фото, сельскохозяйственный анализ
Оценка позы
Что это делает: Обнаруживает ключевые точки тела для отслеживания скелета.
Формат метки: class_id cx cy w h kx1 ky1 v1 kx2 ky2 v2 ...
- Флаги видимости:
0=не размечено,1=размечено, но скрыто,2=размечено и видно
Пример: 0 0.5 0.5 0.2 0.3 0.6 0.7 2 0.4 0.8 1 — Человек с 2 ключевыми точками
Варианты использования: Спортивный анализ, физиотерапия, анимация, распознавание жестов
Ориентированная ограничивающая рамка (OBB)
Что это делает: Обнаруживает повернутые объекты с помощью рамок, учитывающих угол наклона.
Формат метки: class_id x1 y1 x2 y2 x3 y3 x4 y4 (четыре угловые точки, нормализованные)
Пример: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Повернутый прямоугольник
Варианты использования: Аэросъемка, анализ документов, инспекция производства, обнаружение судов
Классификация изображений
Что это делает: Назначает одну метку всему изображению.
Формат метки: На основе папок — изображения упорядочены по имени класса (train/cats/, train/dogs/)
Варианты использования: Модерация контента, контроль качества, медицинская диагностика, распознавание сцен
Начало работы#
Чтобы разметить изображения:
- Перейди к своему набору данных
- Нажми на изображение один раз, чтобы открыть редактор разметки во весь экран
- Используй режим по умолчанию
Drawили переключись наSmart, где это поддерживается - Выбери класс и добавь или настрой разметку прямо на изображении
- Перейди к другому изображению или закрой редактор; изменения сохраняются автоматически после каждого редактирования
Для наборов данных, которые ты можешь редактировать, элементы управления разметкой активны сразу после открытия полноэкранного просмотрщика на десктопе. Отдельного режима редактирования или кнопки Edit не существует. На мобильных устройствах, а также если у тебя нет доступа на редактирование, полноэкранный просмотрщик доступен только для чтения.

graph LR
A[Open Dataset]:::start --> B[Click Image]:::proc
B --> C[Annotate in Fullscreen]:::proc
C --> D[Changes Auto-Save]:::out
D --> E[Next Image]:::proc
E --> B
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef out fill:#9C27B0,color:#fffРежимы аннотирования#
Draw — это режим по умолчанию для задач пространственной разметки. Для датасетов detect, segment, semantic и OBB панель инструментов также предоставляет режим Smart, когда интеллектуальная разметка доступна:
| Режим | Описание | Сочетание клавиш |
|---|---|---|
| Draw | Стандартный ручной режим с инструментами рисования для конкретной задачи | V |
| Умный | Аннотирование с помощью моделей SAM или YOLO (только детекция, сегментация, семантика, OBB) | S |
Разметка поз использует Draw с шаблоном скелета. Классификация использует боковую панель классов напрямую и не отображает панель инструментов рисования.
Интеллектуальная разметка в настоящее время недоступна для подключенных наборов данных.
Инструменты режима Draw#
Ограничивающая рамка (Detect)#
Рисуй прямоугольные рамки вокруг объектов:
- Выбери класс на боковой панели классов
- В режиме по умолчанию
Drawнажми и перетащи курсор, чтобы нарисовать прямоугольник - Отпусти кнопку мыши, чтобы завершить рамку

- Перетаскивай 8 угловых/боковых маркеров для изменения размера
- Перетаскивай центр для перемещения
- Нажми
DeleteилиBackspaceдля удаления выбранной аннотации
Полигон (Segment)#
Рисуй точные полигональные маски:
- Выбери класс на боковой панели классов
- В режиме по умолчанию
Drawнажми, чтобы добавить вершины, или удерживайShiftи перемещай мышь для свободного рисования плотных точек - Дважды нажми, кликни по первой вершине или нажми
EnterлибоEscape, чтобы замкнуть полигон

- Перетаскивай отдельные вершины для корректировки
- Перетаскивай весь полигон для перемещения
- Нажми на вершину и нажми
Delete, чтобы удалить её
Ключевая точка (Pose)#
Размечай позы, используя шаблоны скелета. Выбери шаблон на панели инструментов, нажми один раз, чтобы разместить все ключевые точки, затем перетаскивай отдельные точки для корректировки позиций.
- Выбери класс на боковой панели классов
- В режиме по умолчанию
Drawвыбери шаблон скелета из выбора шаблонов на панели инструментов - Нажми на изображение, чтобы разместить все ключевые точки сразу
- Перетаскивай отдельные ключевые точки для корректировки их позиций

Встроенные шаблоны скелетов#
Редактор включает 5 встроенных шаблонов:
| Шаблон | Ключевые точки | Описание |
|---|---|---|
| Person | 17 | Поза человеческого тела COCO — нос, глаза, уши, плечи, локти, запястья, бедра, колени, лодыжки |
| Hand | 21 | Ultralytics Hand Keypoints — суставы запястья, большого, указательного, среднего, безымянного пальцев и мизинца |
| Лицо | 68 | Ориентиры лица iBUG 300W — челюсть, брови, нос, глаза, рот |
| Собака | 18 | Поза животного AP-10K — нос, голова, шея, плечи, основание хвоста, хвост и 4 лапы (локти, коленные суставы, лапы) |
| Рамка | 4 | Угловые ключевые точки — верхняя левая, верхняя правая, нижняя правая, нижняя левая |

Пользовательские шаблоны скелета#
Создавай собственные шаблоны для любой структуры позы:
- Нажми кнопку + рядом с выбором шаблона
- При желании нажми Start from..., чтобы загрузить ключевые точки и соединения из существующего шаблона в качестве отправной точки
- Размещай ключевые точки на холсте кликами
- Называй каждую ключевую точку и настраивай цвета
- Соединяй ключевые точки, выбирая две точки (соединения рисуются автоматически по мере размещения последовательных ключевых точек)
- Сохрани шаблон для повторного использования в своем наборе данных
Пользовательские шаблоны сохраняются в твоем аккаунте и доступны во всех датасетах поз.
Система шаблонов заменяет ручное последовательное размещение ключевых точек. Вместо того чтобы кликать 17 раз для скелета COCO, выбери шаблон Person и кликни один раз — все ключевые точки будут размещены в правильной структуре скелета. Затем перетаскивай их для корректировки позиций под конкретную позу.
У каждой ключевой точки есть флаг видимости: 0 = не размечена, 1 = размечена, но скрыта, 2 = размечена и видна. Скрытые ключевые точки (находящиеся за другими объектами) следует помечать видимостью 1 — модель научится определять их положение.
Ориентированная ограничивающая рамка (OBB)#
Рисуй повернутые рамки для объектов под углом:
- Выбери класс на боковой панели классов
- В режиме по умолчанию
Drawнажми и перетащи курсор, чтобы нарисовать начальный бокс - Используй маркер поворота для настройки угла
- Перетаскивай угловые маркеры для изменения размера

Классификация (Classify)#
Назначай метки классов для изображения:
- Нажми на изображение, чтобы открыть полноэкранный редактор
- Выбери класс на боковой панели классов или нажми клавишу с цифрой от
1-9

Умная аннотация#
Умная аннотация добавляет в редактор функции аннотирования с поддержкой моделей. В режиме Smart ты можешь использовать Segment Anything Model (SAM) для аннотирования на основе кликов или использовать предобученные модели Ultralytics YOLO и свои собственные дообученные модели YOLO, чтобы добавлять предсказания в качестве аннотаций. Умная аннотация доступна для задач detect, segment, semantic и OBB.
Умная аннотация SAM#
При выбранной модели SAM:
- Выбери
Smartили нажмиS - Кликни на объект, который хочешь разметить — SAM создаст начальную маску в реальном времени
- Уточни маску дополнительными кликами: кликни снаружи текущей маски, чтобы расширить охват, или кликни внутри текущей маски, чтобы вычесть области
- Нажми
EnterилиEscapeдля сохранения аннотации, или включи auto-apply для работы в один клик

graph LR
A[Press S]:::start --> B[Left-click Object]:::proc
B --> C[SAM Generates Mask]:::proc
C --> D{Auto-apply?}:::decide
D -->|Yes| E[Mask Applied Automatically]:::out
D -->|No| F{Accurate?}:::decide
F -->|Yes| G[Enter to Save]:::out
F -->|No| H[Add +/- Points]:::proc
H --> C
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef decide fill:#FF9800,color:#fff
classDef out fill:#9C27B0,color:#fff- Начни с клика по центру объекта
- Кликни еще раз вне маски, чтобы расширить охват
- Кликни внутри маски, чтобы удалить ненужные области
- Включи auto-apply (
A) для разметки в один клик - Удерживай
Shiftпри включенном auto-apply, чтобы разместить несколько точек до того, как маска будет применена - Лучше всего работает для отчетливых объектов с четкими краями
- Используй несколько кликов уточнения для вытянутых или перекрывающихся объектов
Умная аннотация SAM может генерировать:
- Полигоны для задач сегментации
- Bounding boxes для задач детектирования
- Ориентированные рамки для задач OBB
Умная аннотация SAM доступна только для задач detect, segment, semantic и OBB. Задачи классификации и позы требуют ручной разметки.
Режим автоприменения (Auto-Apply)#
Режим автоприменения ускоряет умную аннотацию, автоматически сохраняя маску SAM после каждого клика — не нужно нажимать Enter. Переключай его с помощью кнопки автоприменения на панели инструментов или нажми A.
| Режим | Поведение |
|---|---|
| Auto-apply ВКЛ | Маска применяется автоматически после каждого клика |
Auto-apply ВКЛ + Shift | Размещай несколько точек сначала, маска применяется после отпускания |
| Auto-apply ВЫКЛ (по умолчанию) | Размещай точки свободно, нажми Enter для применения |

Автоприменение идеально подходит для наборов данных с хорошо разделенными объектами, где один клик создает точную маску. Для сложных или перекрывающихся объектов выключи автоприменение и используй несколько положительных/отрицательных точек для уточнения маски перед сохранением.
Выбор модели SAM#
Когда активен режим Smart, на панели инструментов появляется выбор модели. Доступно пять моделей SAM — выбирай исходя из баланса скорости и точности, подходящего для твоего набора данных:
| Модель | Размер | Скорость | Примечания |
|---|---|---|---|
| SAM 2.1 Tiny | 75 МБ | Самая быстрая | |
| SAM 2.1 Small | 88 МБ | Быстрая | |
| SAM 2.1 Base | 154 МБ | Средняя | |
| SAM 2.1 Large | 428 МБ | Более медленная | Самая точная из SAM 2.1 |
| SAM 3 | 3.45 ГБ | Самая медленная | По умолчанию, последнее поколение |
Переключение моделей во время активности режима Smart автоматически перезапускает предиктор для текущего изображения.
Умная аннотация YOLO#
При выбранной модели YOLO умная аннотация может добавлять предсказания из предобученных моделей Ultralytics или твоих собственных дообученных моделей.
- Выбери
Smartили нажмиS - Выбери модель YOLO в инструменте выбора моделей на панели инструментов (
OfficialилиMy Models) - Нажми
Predict - Проверь добавленные аннотации и внеси необходимые исправления

- Выбор модели отображает только те модели, которые соответствуют текущей задаче набора данных.
- Дублирующиеся предсказания пропускаются, если они перекрывают существующую аннотацию того же класса с IoU
0.7или выше.
Боковая панель классов#
Редактор аннотаций включает сворачиваемую боковую панель классов справа от холста. Панель предоставляет:
- Поиск классов: Фильтруй список классов, вводя текст в поле поиска. Нажми
Enterпри точном совпадении, чтобы выбрать его, или создай новый класс, если совпадений нет. - Создание нового класса (встроенное): Нажми
Add classвнизу списка, введи имя и при желании выбери произвольный цвет. НажмиEnterдля создания. - Редактирование имени класса (встроенное): Наведи курсор на имя класса и нажми иконку карандаша, чтобы переименовать его.
- Выбор цвета: Нажми на образец цвета рядом с любым классом, чтобы изменить его.
- Количество аннотаций для класса: Каждая строка класса отображает надстрочный счетчик аннотаций.
- Развернуть/свернуть: Нажми на шеврон, чтобы развернуть класс и увидеть отдельные аннотации под ним.
- Двусторонняя подсветка при наведении: Наведение на аннотацию на холсте подсвечивает её на боковой панели, и наоборот. Боковая панель автоматически прокручивается к нужному классу.
- Скрытие/отображение отдельных аннотаций: Нажми иконку глаза на строке любой аннотации, чтобы переключить её видимость на холсте.
- Удаление аннотаций: Нажми иконку корзины на строке любой аннотации, чтобы удалить её.
- Горячие клавиши: Нажимай
1-9, чтобы быстро выбрать первые 9 классов.
Контекстное меню#
Нажми правой кнопкой мыши на выбранные аннотации, чтобы открыть контекстное меню с пунктами:
| Действие | Сочетание клавиш |
|---|---|
| Удалить аннотацию(и) | Delete / Backspace |
| На передний план | Cmd/Ctrl+Shift+] |
| На задний план | Cmd/Ctrl+Shift+[ |
| Переместить вперед | Cmd/Ctrl+] |
| Переместить назад | Cmd/Ctrl+[ |
Управление видимостью#
Выпадающее меню видимости (иконка глаза) позволяет переключать отображение отдельных элементов:
| Переключатель | Описание |
|---|---|
| Аннотации | Показать или скрыть все наложения аннотаций |
| Метки классов | Показать или скрыть метки имен классов на аннотациях |
| Показать пиксели | Включить пиксельный рендеринг для детального осмотра при увеличении (полноэкранный режим) |
| Перекрестие | Отображать курсор-перекрестие с координатами пикселей во время разметки |
| Миниатюры навигации | Показать полосу миниатюр навигации (полноэкранный режим) |
| Нижняя информационная панель | Показать или скрыть информационную панель изображения внизу (полноэкранный режим) |
| Показать все | Одновременно переключить аннотации, метки, перекрестие, миниатюры и нижнюю панель информации (не влияет на пикселизацию) |
Курсор-перекрестие#
Во время разметки наложение с перекрестием отслеживает положение курсора и отображает координаты пикселей на холсте. Это помогает размещать аннотации с высокой точностью. Переключай его с помощью выпадающего списка видимости.
Предпросмотр SAM при наведении#
В умном режиме SAM предоставляет предпросмотр в реальном времени при наведении курсора перед тем, как ты нажмешь на точки. Этот предпросмотр доступен для задач detect, segment, semantic и OBB. Как только ты добавишь уточняющие клики, предпросмотр обновится, отражая текущую маску и тип аннотации для активной задачи.
Редактирование вершин полигона#
Для сегментационных аннотаций ты можешь редактировать вершины полигона после отрисовки:
- Перемещение вершин: Перетащи любой маркер вершины, чтобы изменить его положение
- Удаление вершин: Выбери вершину и нажми
Delete, чтобы удалить её
Управление классами#
Создание классов#
Определи классы аннотаций для своего набора данных на вкладке Classes:
- Перейди на вкладку
Classes - Используй поле ввода внизу, чтобы ввести имя класса
- Нажми
Addили нажмиEnter - Цвет назначается автоматически из палитры Ultralytics

Добавление нового класса во время аннотирования#
Ты можешь создавать новые классы прямо во время аннотирования, не покидая редактор:
- Нарисуй аннотацию на изображении
- На боковой панели классов нажми
Add class(или введи новое имя в поле поиска на боковой панели) - Введи имя класса
- Нажми Enter для создания и назначения
Это обеспечивает бесшовный рабочий процесс, где ты можешь определять классы по мере появления новых типов объектов в твоих данных.
Все классы в наборе данных управляются в единой таблице. Изменения имен классов или цветов автоматически применяются ко всему набору данных.
Редактирование классов#
- Переименование: Нажми на имя класса в таблице, чтобы отредактировать его
- Изменение цвета: Нажми на образец цвета, чтобы открыть палитру
- Поиск: Используй поле поиска для фильтрации классов по имени
- Сортировка: Нажимай на заголовки столбцов для сортировки по индексу, имени, количеству аннотаций или количеству изображений
Цвета классов#
Каждому классу присваивается цвет из палитры Ultralytics. Ты можешь настраивать цвета с помощью выбора цвета на вкладке Classes; выбранные цвета используются во всем этом наборе данных.
Горячие клавиши#
Эффективная аннотация с помощью горячих клавиш:
| Сочетание клавиш | Действие |
|---|---|
Cmd/Ctrl+S | Сохранить аннотации |
Cmd/Ctrl+Z | Отменить |
Cmd/Ctrl+Y | Вернуть |
Escape | Сохранить / Отменить выбор / Выход |
Delete / Backspace | Удалить выбранную аннотацию |
1-9 | Выбрать класс 1-9 |
Cmd/Ctrl+Scroll | Увеличить/уменьшить масштаб |
Cmd/Ctrl++ или Cmd/Ctrl+= | Увеличить масштаб |
Cmd/Ctrl+- | Уменьшить масштаб |
Cmd/Ctrl+0 | Сбросить до размера окна |
Space+Drag | Панорамирование холста при увеличении |
Shift+Click | Множественный выбор аннотаций |
Cmd/Ctrl+A | Выбрать все аннотации |
Cmd/Ctrl+C | Копировать выбранные аннотации |
Cmd/Ctrl+X | Вырезать выбранные аннотации |
Cmd/Ctrl+V | Вставить аннотации |

Посмотреть все сочетания клавиш
Нажми на иконку клавиатуры на панели инструментов аннотирования, чтобы открыть справочник сочетаний клавиш.
Отмена/Возврат действия#
Редактор аннотаций ведет полную историю отмены/возврата действий:
- Отмена:
Cmd/Ctrl+Z - Возврат:
Cmd/Ctrl+Y
История отслеживает:
- Добавление аннотаций (одиночное и пакетное)
- Редактирование аннотаций (перемещение, изменение размера, поворот)
- Удаление аннотаций (одиночное и пакетное)
- Изменение классов (одиночное и пакетное)
- Изменение порядка аннотаций (z-order)
- Редактирование вершин полигона (добавление, удаление, перемещение)
- Перемещение ключевых точек
Стек отмены не имеет фиксированного лимита — ты можешь отменять изменения, сделанные с момента открытия изображения.
Сохранение аннотаций#
Изменения сохраняются автоматически через одну секунду после последнего редактирования разметки. Они также сохраняются при переходе к другому изображению или закрытии полноэкранного редактора.
- Сохранить сейчас: Нажми кнопку сохранения или используй сочетание клавиш
Cmd/Ctrl+S - Закрыть: Нажми кнопку закрытия, кликни вне изображения или нажми
Escape; закрытие инициирует фоновое сохранение ожидающих изменений
Дождись исчезновения статуса Saving... или Unsaved на информационной панели изображения, прежде чем закрывать вкладку браузера. Ты можешь сохранить изменения вручную в любое время с помощью кнопки сохранения или Cmd/Ctrl+S.
FAQ#
Насколько точна аннотация SAM?#
SAM предоставляет высококачественные маски для большинства объектов. Точность зависит от:
- Отличимости объекта от фона
- Качества и разрешения изображения
- Количества предоставленных положительных/отрицательных точек
Для достижения наилучших результатов начни с клика по центру объекта, затем используй клики вне маски, чтобы добавить охват, и клики внутри маски, чтобы вычесть близлежащие объекты или фон.
Могу ли я импортировать существующие аннотации?#
Да, загрузи свой датасет с файлами меток в формате YOLO. Платформа автоматически распознает и отобразит их в редакторе.
Как аннотировать несколько объектов одного класса?#
После рисования аннотации:
- Оставь выбранным тот же класс
- Нарисуй следующую аннотацию
- Повторяй, пока все объекты не будут размечены
Сочетание клавиш 1-9 позволяет быстро выбирать классы.
Могу ли я обучать на частично аннотированных датасетах?#
Да, но для достижения наилучших результатов:
- Разметь все объекты целевых классов на каждом изображении
- Используй фильтр
Annotations, установленный наUnannotated, чтобы найти изображения, которые еще нуждаются в аннотировании
Какую модель SAM мне использовать?#
SAM 3 — это модель по умолчанию и новейшего поколения, начни с нее для получения масок высочайшего качества. Переключись на SAM 2.1 Small для более быстрого интерактивного рабочего процесса с обычными объектами или SAM 2.1 Large, когда тебе нужна более высокая точность маски для сложных форм. Используй SAM 2.1 Tiny для максимальной скорости на простых, контрастных объектах.
Какие задачи поддерживают умное аннотирование SAM?#
Умное аннотирование SAM доступно для задач detect, segment, semantic и OBB. Задачи классификации и оценки позы используют только ручное аннотирование.
Могу ли я создавать пользовательские шаблоны скелетов для аннотирования позы?#
Да. Нажми кнопку + рядом с выбором шаблона скелета, чтобы открыть редактор шаблонов. Размещай ключевые точки, называй их, рисуй связи и сохраняй. Пользовательские шаблоны хранятся в твоем аккаунте и доступны для всех датасетов с позами.
Как переключаться между шаблонами скелетов?#
Нажми на выпадающий список шаблонов на панели инструментов аннотирования. Выбери любой встроенный шаблон (Person, Hand, Face, Dog, Box) или свои сохраненные пользовательские шаблоны. Выбранный шаблон определяет, какие ключевые точки будут размещены при клике по изображению.