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

graph TB
subgraph Draw["Shape set by the dataset task"]
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 типов аннотаций сохраняются вместе для каждого изображения. Ты можешь переключать активный тип задачи для набора данных, не теряя существующие аннотации — они сохраняются и появляются снова, когда ты переключаешься обратно.
Ground truth глубины — это загружаемая парная карта, а не то, что ты рисуешь, поэтому редактор открывается в режиме только чтения для датасета глубины.
Детали задачи#
Детекция объектов
Что это делает: Идентифицирует объекты и их расположение с помощью выровненных по осям ограничивающих рамок.
Формат разметки: 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 — это режим по умолчанию для задач пространственной разметки. Для датасетов детекции, сегментации, семантической разметки и OBB панель инструментов также предоставляет режим Smart, когда доступна умная разметка:
| Режим | Описание | Сочетание клавиш |
|---|---|---|
| Draw | Стандартный ручной режим с инструментами рисования для конкретной задачи | V |
| Умный | Аннотирование с помощью моделей SAM или YOLO (только детекция, сегментация, семантика, OBB) | S |
Разметка точек использует Draw с шаблоном скелета — кнопка Smart появляется, но отключена и помечена как "Скоро". Классификация использует боковую панель классов напрямую и вообще не отображает панель инструментов рисования или кнопку Smart.
Умная разметка в настоящее время недоступна для подключенных датасетов, поддерживаемых облачным хранилищем или хранилищем On Premise.
Инструменты режима Draw#
Ограничивающая рамка (Detect)#
Рисуй прямоугольные рамки вокруг объектов:
- Выбери класс на боковой панели классов
- В режиме по умолчанию
Drawнажми и перетащи мышь, чтобы нарисовать прямоугольник - Отпусти кнопку мыши, чтобы завершить рамку

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

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

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

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

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

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

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- Начни с клика по центру объекта
- Кликни еще раз вне маски, чтобы расширить охват
- Кликни внутри маски, чтобы удалить ненужные области
- Включи автоприменение (
A) для разметки в один клик - Удерживай
Shift, пока включено автоприменение, чтобы расставить несколько точек перед применением маски - Лучше всего работает для отчетливых объектов с четкими краями
- Используй несколько кликов уточнения для вытянутых или перекрывающихся объектов
Умная аннотация SAM может генерировать:
- Полигоны для задач сегментации
- Bounding boxes для задач детектирования
- Ориентированные рамки для задач OBB
Умная разметка SAM доступна только для задач detect, segment, semantic и OBB. Для поз и классификации требуется ручная разметка.
Режим автоприменения (Auto-Apply)#
Режим автоприменения ускоряет умную разметку за счет автоматического сохранения маски SAM после каждого клика — не нужно нажимать Enter. Переключай его с помощью кнопки автоприменения на панели инструментов или нажатием A.
| Режим | Поведение |
|---|---|
| Auto-apply ВКЛ | Маска применяется автоматически после каждого клика |
Автоприменение ВКЛ + Shift | Размещай несколько точек сначала, маска применяется после отпускания |
| Auto-apply ВЫКЛ (по умолчанию) | Свободно расставляй точки, нажми Enter для применения |

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

- Выбор модели отображает только те модели, которые соответствуют текущей задаче набора данных.
- Дублирующие предсказания пропускаются, если они пересекаются с существующей разметкой того же класса при IoU
0.7или выше.
Боковая панель классов#
Редактор аннотаций включает сворачиваемую боковую панель классов справа от холста. Панель предоставляет:
- Поиск классов: отфильтруй список классов, введя текст в поле поиска. Нажми
Enterпри точном совпадении, чтобы выбрать его, или создай новый класс, если совпадений нет. - Создание нового класса в списке: кликни
Add classвнизу списка, введи имя и при желании выбери собственный цвет. НажмиEnter, чтобы создать. - Редактирование имени класса (встроенное): Наведи курсор на имя класса и нажми иконку карандаша, чтобы переименовать его.
- Выбор цвета: Нажми на образец цвета рядом с любым классом, чтобы изменить его.
- Количество аннотаций для класса: Каждая строка класса отображает надстрочный счетчик аннотаций.
- Развернуть/свернуть: Нажми на шеврон, чтобы развернуть класс и увидеть отдельные аннотации под ним.
- Двусторонняя подсветка при наведении: Наведение на аннотацию на холсте подсвечивает её на боковой панели, и наоборот. Боковая панель автоматически прокручивается к нужному классу.
- Скрыть/показать весь класс: Нажми на иконку глаза в строке класса, чтобы скрыть или показать все разметки этого класса одновременно.
- Скрытие/отображение отдельных аннотаций: Нажми иконку глаза на строке любой аннотации, чтобы переключить её видимость на холсте.
- Удаление аннотаций: Нажми иконку корзины на строке любой аннотации, чтобы удалить её.
- Горячие клавиши: Нажми
1-9, чтобы быстро выбрать первые 9 классов, илиH, чтобы переключить видимость всей разметки на изображении.
Контекстное меню#
Нажми правой кнопкой мыши на выбранные аннотации, чтобы открыть контекстное меню с пунктами:
| Действие | Сочетание клавиш |
|---|---|
| Удалить аннотацию(и) | 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 | Удалить выбранную аннотацию |
Cmd/Ctrl+Delete | Удалить изображение |
H | Переключить всю разметку |
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 предоставляет высококачественные маски для большинства объектов. Точность зависит от:
- Отличимости объекта от фона
- Качества и разрешения изображения
- Количества предоставленных положительных/отрицательных точек
Для достижения наилучших результатов начни с клика по центру объекта, затем используй клики вне маски, чтобы добавить охват, и клики внутри маски, чтобы вычесть близлежащие объекты или фон.
Да. Загрузи свой датасет с файлами меток формата YOLO, файлами разметки COCO JSON или экспортом Ultralytics NDJSON. Платформа разбирает их во время обработки и отображает в редакторе. Метки Pascal VOC XML не импортируются — сначала конвертируй их в YOLO или COCO. См. Подготовка твоего датасета.
После рисования аннотации:
- Оставь выбранным тот же класс
- Нарисуй следующую аннотацию
- Повторяй, пока все объекты не будут размечены
Горячая клавиша
1-9позволяет быстро выбирать классы.Да, но для достижения наилучших результатов:
- Разметь все объекты целевых классов на каждом изображении
- Используйте набор фильтров
Annotations, установленный вUnannotated, чтобы найти изображения, которые еще нуждаются в разметке
SAM 3 — это модель по умолчанию и новейшего поколения, начни с нее для получения масок высочайшего качества. Переключись на SAM 2.1 Small для более быстрого интерактивного рабочего процесса с обычными объектами или SAM 2.1 Large, когда тебе нужна более высокая точность маски для сложных форм. Используй SAM 2.1 Tiny для максимальной скорости на простых, контрастных объектах.
Умная разметка SAM доступна для задач detect, segment, semantic и OBB. Для поз и классификации используется только ручная разметка — на датасетах поз кнопка
Smartвидна, но отключена и помечена как "Скоро". Умная разметка также недоступна в подключенных облачных датасетах и датасетах On Premise.Да. Нажми кнопку + рядом с выбором шаблона скелета, чтобы открыть редактор шаблонов. Размещай ключевые точки, называй их, рисуй связи и сохраняй. Пользовательские шаблоны хранятся в твоем аккаунте и доступны для всех датасетов с позами.
Нажми на выпадающий список выбора шаблона на панели инструментов разметки. Выбери любой встроенный шаблон (Человек, Рука, Собака, Лицо, Бокс) или сохраненные пользовательские шаблоны. Выбранный шаблон определяет, какие ключевые точки размещаются при клике на изображение.
Да. Выбери одну или несколько разметок, нажми
Cmd/Ctrl+Cдля копирования (илиCmd/Ctrl+Xдля вырезания), перейди к другому изображению с помощью стрелок на клавиатуре или полосы миниатюр и нажмиCmd/Ctrl+Vдля вставки. Буфер обмена сохраняется, пока открыт полноэкранный редактор.