Как размечать данные в CVAT: пошаговая инструкция

CVAT — мощный инструмент, но его интерфейс не всегда очевиден с первого раза. Разбираем весь путь по шагам: от создания проекта и загрузки данных до разметки bounding box и полигонов, интерполяции видео, экспорта результата и типичных ошибок, которые чаще всего допускают новички.

Автор: Редакция DataMarkupОпубликовано: 2026-07-14
Как размечать данные в CVAT: пошаговая инструкция — иллюстрация к статье

Как создать проект и задачу в CVAT?

Работа в CVAT начинается с проекта — в нём задают общий набор классов (меток) для будущих датасетов. Внутри проекта создают одну или несколько задач (task): именно к задаче потом загружают конкретные изображения или видео. Разделение на проект и задачу удобно, когда несколько партий данных размечают по одному и тому же гайдлайну.

На этапе создания задачи стоит сразу продумать структуру меток и их атрибуты — добавить класс или атрибут позже несложно, но уже размеченные кадры при этом переразмечать не придётся. Здесь же настраивают, кто из команды получит доступ к задаче и на сколько job она будет разбита.

Хорошей практикой считается заранее договориться внутри команды о единых названиях классов и порядке их перечисления — это упрощает работу, когда к проекту позже подключаются новые задачи или разметчики, а список меток уже согласован и зафиксирован.

Как загрузить изображения или видео в задачу CVAT?

Данные загружают прямо через веб-интерфейс: можно перетащить файлы, указать папку на сервере или подключить облачное хранилище как источник. CVAT принимает как отдельные изображения, так и видеофайлы целиком — во втором случае инструмент сам нарезает видео на кадры с заданным шагом, не требуя предварительной подготовки.

При загрузке большого объёма данных полезно сразу задать разумный шаг нарезки кадров видео и порядок сортировки файлов — от этого зависит, насколько удобно будет ориентироваться в задаче позже, особенно если её разобьют на несколько job для параллельной работы команды.

Если источник данных — облачное хранилище, а не локальные файлы, стоит заранее проверить права доступа и скорость соединения: загрузка большого архива видео при нестабильном канале может занять заметно больше времени, чем ожидается.

Как разметить bounding box в CVAT?

Чтобы поставить bounding box, выбирают инструмент прямоугольника, класс объекта из списка меток и рисуют рамку по двум противоположным углам объекта на кадре. Готовую рамку можно двигать, растягивать за угловые маркеры и копировать на соседние кадры, если объект почти не смещается между ними.

Для ускорения работы удобно заранее решить, насколько плотно рамка должна облегать объект — единый критерий точности рамки, зафиксированный в гайдлайне, сильно снижает разброс между разметчиками и упрощает последующую проверку качества.

Полезно периодически проверять точность рамок на случайной выборке кадров прямо в процессе разметки, а не только по завершении задачи — так расхождения с гайдлайном находят раньше и не приходится переразмечать большой объём кадров позже.

Как размечать полигоны и сегментацию в CVAT?

Полигон рисуют, расставляя точки по контуру объекта одну за другой, пока фигура не замкнётся, — CVAT позволяет двигать и добавлять точки уже после того, как контур готов. Для попиксельной сегментации в CVAT есть отдельный инструмент маски с кистью и ластиком, которым закрашивают область объекта напрямую, без расстановки отдельных точек.

Полигоны обычно быстрее сегментации и подходят для большинства задач, где нужен точный контур, а не абсолютная попиксельная граница; к маскам стоит переходить только там, где задача модели прямо требует такой точности — например, при разметке медицинских снимков.

Выбор между полигоном и маской стоит фиксировать в гайдлайне заранее, а не оставлять на усмотрение разметчика: разные разметчики иначе выбирают инструмент по-разному, и итоговый датасет получается неоднородным по типу разметки одних и тех же классов объектов.

Как работает интерполяция при разметке видео в CVAT?

Интерполяцию включают на треке объекта: разметчик расставляет рамку или контур на нескольких ключевых кадрах, а CVAT автоматически рассчитывает положение объекта на кадрах между ними. Если объект движется линейно и предсказуемо, достаточно двух-трёх опорных кадров на весь отрезок трека, а при сложной траектории их число стоит увеличить.

После автоматического расчёта стоит пройтись по нескольким промежуточным кадрам и проверить, насколько точно интерполяция угадала положение объекта — при резких поворотах или ускорении движения расчёт может ошибаться, и тогда лучше добавить ещё один опорный кадр в этом месте трека.

На видео с резкими сменами направления движения или частичными перекрытиями лучше сокращать шаг между опорными кадрами — так интерполяция реже ошибается, а количество ручных правок на этапе проверки заметно снижается.

Какие горячие клавиши ускоряют разметку в CVAT?

Больше всего времени экономят клавиши переключения между кадрами, быстрый выбор инструмента разметки без обращения к панели мышью и клавиша копирования объекта на следующий кадр. У CVAT есть встроенная подсказка со списком горячих клавиш прямо в интерфейсе — с неё удобно начать, не запоминая всё сразу.

Опытные разметчики почти не используют мышь для рутинных операций — переключения кадра, класса объекта и статуса трека делают клавиатурой, а мышь оставляют только для самого рисования рамки или контура. На больших объёмах данных эта привычка ощутимо сокращает время на партию.

Список используемых горячих клавиш имеет смысл распечатать или закрепить рядом с рабочим местом на первую неделю работы — большинство разметчиков переходят на них автоматически уже после нескольких дней практики на реальных задачах.

Как экспортировать готовую разметку из CVAT?

Экспорт запускают из меню задачи или проекта, выбрав целевой формат — COCO, YOLO, Pascal VOC, CVAT XML и другие поддерживаемые варианты. CVAT формирует архив с файлами разметки и, если нужно, с самими изображениями, который можно сразу подключать к пайплайну обучения модели.

Перед экспортом стоит убедиться, что все job задачи закрыты и прошли проверку, — экспортированный датасет фиксирует текущее состояние разметки, и повторный экспорт после доработки означает, что предыдущую версию файлов нужно будет заменить вручную в пайплайне обучения.

Если датасет экспортируют регулярно по мере поступления новых партий данных, удобно сразу выработать единую схему именования файлов экспорта с датой и номером партии — это заметно упрощает работу с версиями датасета в пайплайне обучения.

Какие ошибки чаще всего допускают новички в CVAT?

Самые частые ошибки — начинать разметку без зафиксированного гайдлайна, из-за чего разные разметчики по-разному трактуют спорные случаи; забывать про атрибут «вне кадра» при интерполяции; и экспортировать датасет раньше, чем задача прошла проверку. Каждая такая ошибка обычно всплывает уже на этапе обучения модели.

Ещё одна типичная проблема — слишком редкие опорные кадры при интерполяции на видео со сложным движением: результат выглядит правдоподобно на первый взгляд, но при детальной проверке рамка заметно «плывёт» относительно объекта. Регулярный выборочный аудит нескольких кадров прямо по ходу разметки помогает поймать такие расхождения раньше, чем датасет уйдёт в обучение.

Ещё одна распространённая ошибка — игнорировать разбиение задачи на job при командной работе: без этого несколько человек рискуют случайно разметить одни и те же кадры или, наоборот, пропустить часть данных без явного распределения ответственности.

Частые вопросы

Нужно ли устанавливать CVAT, чтобы начать размечать?

Нет, для старта достаточно облачной версии cvat.ai, которая работает прямо в браузере без установки. Разворачивать открытый CVAT через Docker на своём сервере имеет смысл, только если данные нельзя передавать во внешний сервис или нужна глубокая кастомизация под собственный пайплайн.

Как разметить несколько классов объектов в одной задаче?

Все классы объектов задаются заранее на уровне проекта или задачи — в разделе меток указывают название каждого класса и при необходимости цвет и атрибуты. После этого при разметке разметчик просто выбирает нужный класс из списка перед тем, как выделить объект на кадре.

Можно ли поручить разметку в CVAT нескольким людям одновременно?

Да, CVAT делит задачу на отдельные job — сегменты кадров или изображений, — и каждый job можно назначить своему разметчику. Это позволяет команде работать над одним датасетом параллельно, а руководителю проекта — отслеживать статус каждого сегмента и организовать проверку результата отдельным этапом.

Что делать, если объект временно закрыт другим предметом на видео?

На этом промежутке трек объекта нужно пометить атрибутом «вне кадра» (outside) — интерполяция корректно прервётся и не будет достраивать рамку там, где объект не виден. Как только объект снова появляется в кадре, разметчик заново фиксирует его положение, и интерполяция продолжает работу дальше.

Как проверить качество разметки перед экспортом?

В CVAT у каждого job есть статус проверки: после разметки задачу переводят на этап review, где второй специалист или руководитель проекта сверяет результат с гайдлайном и оставляет замечания. Экспортировать датасет лучше только после того, как все job прошли проверку, а не сразу после разметки.

Нужна такая задача на практике?

Опишите, что у вас за данные и какая цель — вернёмся с планом, сроком и оценкой в течение рабочего дня.

Не любите формы — напишите на info@datamarkup.ru

Смотрите также

Telegramответим за 15 минут