Editor de Anotação
Ultralytics Platform inclui um poderoso editor de anotação para rotular imagens com caixas delimitadoras, polígonos, pontos-chave, caixas orientadas e classificações. O editor suporta desenho manual e anotação inteligente alimentada por SAM.

graph TB
subgraph Manual["Manual Tools"]
A[Box] & B[Polygon] & C[Keypoint] & D[OBB] & E[Classify]
end
subgraph AI["AI-Assisted"]
F[SAM Smart]
end
Manual --> H[Save Labels]
AI --> H
Tipos de Tarefas Suportados
O editor de anotações suporta todos os 5 tipos de tarefas YOLO:
| Tarefa | Ferramenta | Formato de Anotação |
|---|---|---|
| Detectar | Retângulo | Caixas delimitadoras (x, y, largura, altura) |
| Segmentar | Polígono | Máscaras pixel a pixel (vértices do polígono) |
| Pose | Ponto-chave | Modelos de esqueleto (Pessoa, Mão, Rosto, Cão, Caixa, personalizado) |
| OBB | Caixa Orientada | Caixas delimitadoras rotacionadas (4 cantos) |
| Classificar | Seletor de Classe | Rótulos ao nível da imagem |
Detalhes da tarefa
Detecção de Objetos
O que faz: Identifica objetos e suas localizações com caixas delimitadoras alinhadas com os eixos.
Formato da etiqueta:class_id center_x center_y width height (todos normalizados de 0 a 1)
Exemplo: 0 0.5 0.5 0.2 0.3 — Classe 0 centrada em (50%, 50%) com 20% de largura e 30% de altura
Casos de uso: Contagem de inventário, monitoramento de tráfego, detecção de animais selvagens, sistemas de segurança
Segmentação de Instância
O que faz: Cria máscaras com precisão de pixel para cada instância de objeto.
Formato da etiqueta:class_id x1 y1 x2 y2 x3 y3 ... (vértices do polígono, normalizados 0-1)
Exemplo: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Máscara quadrilateral
Casos de uso: Imagens médicas, veículos autónomos, edição de fotos, análise agrícola
Estimativa de Pose
O que faz: Deteta pontos-chave do corpo para rastreamento do esqueleto.
Formato da etiqueta:class_id cx cy w h kx1 ky1 v1 kx2 ky2 v2 ...
- Sinalizadores de visibilidade:
0=sem rótulo,1=rotulado, mas ocluído,2=rotulado e visível
Exemplo: 0 0.5 0.5 0.2 0.3 0.6 0.7 2 0.4 0.8 1 — Pessoa com 2 pontos-chave
Casos de uso: Análise desportiva, fisioterapia, animação, reconhecimento de gestos
Caixa Delimitadora Orientada (OBB)
O que faz: Deteta objetos rodados com caixas delimitadoras sensíveis ao ângulo.
Formato da etiqueta:class_id x1 y1 x2 y2 x3 y3 x4 y4 (quatro pontos de canto, normalizados)
Exemplo: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Retângulo rodado
Casos de uso: Imagens aéreas, análise de documentos, inspeção de fabricação, deteção de navios
Classificação de Imagem
O que faz: Atribui uma única etiqueta a toda a imagem.
Formato da etiqueta:Baseado em pasta — imagens organizadas por nome de classe (train/cats/, train/dogs/)
Casos de uso: moderação de conteúdo, controlo de qualidade, diagnóstico médico, reconhecimento de cena
Começando
Para anotar imagens:
- Navegue até o seu conjunto de dados
- Clique em uma imagem para abrir o visualizador em tela cheia
- Clique
Editpara entrar no modo de anotação - Selecione sua ferramenta de anotação na barra de ferramentas
- Desenhe anotações na imagem
- Clique
Savequando concluído

graph LR
A[Open Dataset] --> B[Click Image]
B --> C[Click Edit]
C --> D[Draw Annotations]
D --> E[Save]
E --> F[Next Image]
F --> B
style C fill:#2196F3,color:#fff
style D fill:#FF9800,color:#fff
style E fill:#4CAF50,color:#fff
Modos de Anotação
O editor oferece dois modos de anotação, selecionáveis na barra de ferramentas:
| Modo | Descrição | Atalho |
|---|---|---|
| Desenhar | Anotação manual com ferramentas específicas para a tarefa | V |
| Inteligente | Anotação interativa alimentada por SAM (detect/segment/OBB) | S |
Ferramentas de Anotação Manual
Caixa Delimitadora (detect)
Desenhe caixas retangulares ao redor dos objetos:
- Entrar no modo de edição e selecionar
Draw - Clique e arraste para desenhar um retângulo
- Solte para completar a caixa
- Selecione uma classe no menu suspenso

Redimensionar e Mover
- Arraste 8 alças de canto/borda para redimensionar
- Arraste o centro para mover
- Pressione
DeleteouBackspacepara remover a anotação selecionada
Polígono (segment)
Desenhe máscaras de polígono precisas:
- Entrar no modo de edição e selecionar
Draw - Clique para adicionar vértices
- Clique com o botão direito ou pressione
Enterpara fechar o polígono - Selecione uma classe no menu suspenso

Editar Vértices
- Arraste vértices individuais para ajustar
- Arraste o polígono inteiro para mover
- Clique em um vértice e pressione
Deletepara removê-lo
Ponto Chave (Pose)
Anote poses usando modelos de esqueleto. Selecione um modelo na barra de ferramentas, clique uma vez para posicionar todos os pontos-chave e, em seguida, arraste os pontos-chave individuais para ajustar as posições.
- Entrar no modo de edição e selecionar
Draw - Escolha um modelo de esqueleto no seletor de modelos na barra de ferramentas

- Clique na imagem para posicionar todos os pontos-chave de uma vez
- Arraste pontos-chave individuais para ajustar suas posições
- Pressione
Enterpara confirmar ouEscapepara cancelar
Modelos de Esqueletos Integrados
O editor inclui 5 modelos incorporados:
| Modelo | Keypoints | Descrição |
|---|---|---|
| Pessoa | 17 | Pose humana COCO — nariz, olhos, orelhas, ombros, cotovelos, pulsos, quadris, joelhos, tornozelos |
| Mão | 21 | Pontos de referência da mão MediaPipe — pulso, polegar, indicador, médio, anelar, articulações do mindinho |
| Rosto | 68 | iBUG 300W pontos de referência faciais — mandíbula, sobrancelhas, nariz, olhos, boca |
| Cão | 18 | Pose de animais — nariz, cabeça, pescoço, ombros, pernas, patas, cauda |
| Caixa | 4 | Pontos-chave de canto — superior esquerdo, superior direito, inferior direito, inferior esquerdo |

Modelos de Esqueletos Personalizados
Crie modelos personalizados para qualquer estrutura de pose:
- Clique no botão + ao lado do seletor de modelo
- Opcionalmente, clique em Começar de... para carregar pontos-chave e conexões de um modelo existente como ponto de partida
- Posicione os keypoints na tela clicando
- Nomeie cada ponto-chave e personalize as cores
- Conecte os pontos-chave selecionando dois pontos (as conexões são desenhadas automaticamente à medida que você posiciona pontos-chave sequenciais)
- Salvar o modelo para reutilização em todo o seu conjunto de dados

Modelos personalizados são salvos em sua conta e estão disponíveis em todos os conjuntos de dados de pose.
Fluxo de Trabalho do Modelo
O sistema de modelos substitui o posicionamento manual sequencial de keypoints. Em vez de clicar 17 vezes para um esqueleto COCO, selecione o modelo Pessoa e clique uma vez — todos os keypoints são posicionados no layout de esqueleto correto. Em seguida, arraste para ajustar as posições para a pose específica.
Visibilidade do Ponto-Chave
Cada keypoint possui um sinalizador de visibilidade: 0 = não rotulado, 1 = rotulado, mas ocluído, 2 = rotulado e visível. Pontos-chave ocluídos (atrás de outros objetos) devem ser marcados com visibilidade 1 — o modelo aprende a inferir a sua posição.
Caixa Delimitadora Orientada (OBB)
Desenhe caixas rotacionadas para objetos angulados:
- Entrar no modo de edição e selecionar
Draw - Clique e arraste para desenhar uma caixa inicial
- Use o manipulador de rotação para ajustar o ângulo
- Arraste as alças dos cantos para redimensionar
- Selecione uma classe no menu suspenso

Classificação (classify)
Atribua rótulos de classe em nível de imagem:
- Entrar no modo de edição
- Um painel lateral aparece com botões de seleção de classe.
- Clique nos botões de classe ou pressione as teclas numéricas
1-9

Anotação Inteligente SAM
Segment Anything Model (SAM) permite anotação inteligente com apenas alguns cliques. O modo inteligente está disponível para tarefas de detect, segment e OBB.
- Entrar no modo de edição e selecionar
Smartou pressioneS - Clique com o botão esquerdo para adicionar pontos positivos (incluir esta área)
- Clique com o botão direito para adicionar pontos negativos (excluir esta área)
- O SAM gera uma máscara precisa em tempo real
- Pressione
EnterouEscapepara guardar a anotação, ou ativar autoaplicar para fluxos de trabalho de um clique

graph LR
A[Press S] --> B[Left-click Object]
B --> C[SAM Generates Mask]
C --> D{Auto-apply?}
D -->|Yes| E[Mask Applied Automatically]
D -->|No| F{Accurate?}
F -->|Yes| G[Enter to Save]
F -->|No| H[Add +/- Points]
H --> C
style A fill:#2196F3,color:#fff
style C fill:#FF9800,color:#fff
style E fill:#4CAF50,color:#fff
style G fill:#4CAF50,color:#fff
Dicas do SAM
- Comece com um clique positivo no centro do objeto
- Adicione cliques negativos para excluir o fundo
- Manter
Alt/Optionpara inverter o comportamento do clique (clique esquerdo torna-se negativo, clique direito torna-se positivo) - Ativar autoaplicar (
A) para anotação com um clique — a máscara é salva automaticamente após cada clique - Manter
Shiftenquanto a aplicação automática está ativada para colocar múltiplos pontos antes que a máscara seja aplicada - Pontos positivos e negativos aparecem como marcadores quadrados com
+e−símbolos na tela - Funciona melhor para objetos distintos com bordas claras
- Utilize 2-3 pontos positivos para objetos alongados
A anotação inteligente SAM pode gerar:
- Polígonos para tarefas de segmentação
- Caixas delimitadoras para tarefas de detecção
- Caixas orientadas para tarefas OBB
Suporte a Tarefas SAM
A anotação inteligente SAM está disponível apenas para tarefas de detect, segment e OBB. As tarefas de classificação e pose exigem anotação manual.
Modo de Autoaplicação
O modo de autoaplicação acelera a anotação inteligente ao salvar automaticamente a máscara SAM após cada clique — sem a necessidade de pressionar Enter. Ative-o com o botão de aplicação automática na barra de ferramentas ou pressione A.
| Modo | Comportamento |
|---|---|
| Aplicação automática ATIVADA (padrão) | A máscara é aplicada automaticamente após cada clique |
Autoaplicar ATIVADO + Shift | Posicione múltiplos pontos primeiro, a máscara é aplicada ao soltar |
| Autoaplicar DESATIVADO | Posicione pontos livremente, pressione Enter para aplicar |

Quando usar o Auto-Apply
O autoaplicar é ideal para conjuntos de dados com objetos bem separados, onde um único clique produz uma máscara precisa. Para objetos complexos ou sobrepostos, desative o autoaplicar e utilize múltiplos pontos positivos/negativos para refinar a máscara antes de salvar.
Seleção de Modelo SAM
Quando o modo Smart está ativo, um seletor de modelo aparece na barra de ferramentas. Cinco modelos estão disponíveis — escolha com base no equilíbrio entre velocidade e precisão que melhor se adapta ao seu conjunto de dados:
| Modelo | Tamanho | Velocidade | Notas |
|---|---|---|---|
| SAM 2.1 Minúsculo | 74.5 MB | Mais Rápido | |
| SAM 2.1 Pequeno | 88 MB | Rápido | Padrão |
| SAM 2.1 Base | 154 MB | Moderado | |
| SAM 2.1 Grande | 428 MB | Mais Lento | Mais preciso do SAM 2.1 |
| SAM 3 | 3.45 GB | Mais Lento | Última geração, novo 2025 |

Ao trocar de modelos enquanto o modo Inteligente está ativo, o preditor é reinicializado automaticamente para a imagem atual.
Barra lateral da turma
O editor de anotações inclui uma barra lateral de classes recolhível no lado direito da tela. A barra lateral fornece:
- Pesquisar classes: Filtre a lista de classes digitando no campo de busca. Pressione
Enterem uma correspondência exata para selecioná-lo, ou criar uma nova classe se nenhuma correspondência existir. - Criar nova classe em linha: Clique
Add classna parte inferior da lista, digite um nome e opcionalmente escolha uma cor personalizada. PressioneEnterpara criar. - Editar nome da classe diretamente: Passe o mouse sobre um nome de classe e clique no ícone de lápis para renomeá-lo.
- Seletor de cores: Clique na amostra de cor ao lado de qualquer classe para alterar a sua cor.
- Contagem de anotações por classe: Cada linha de classe exibe uma contagem de anotações em sobrescrito.
- Expandir/recolher: Clique no chevron para expandir uma classe e ver as anotações individuais listadas abaixo dela.
- Destaque bidirecional ao passar o mouse: Ao passar o mouse sobre uma anotação na tela, ela é destacada na barra lateral, e vice-versa. A barra lateral rola e expande automaticamente para a classe relevante.
- Ocultar/mostrar anotações individuais: Clique no ícone de olho em qualquer linha de anotação para alternar sua visibilidade na tela.
- Excluir anotações: Clique no ícone da lixeira em qualquer linha de anotação para excluí-la.
- Atalhos de teclado: Pressione
1-9para selecionar rapidamente as primeiras 9 classes.
Menu de Contexto
Clique com o botão direito nas anotações selecionadas para abrir um menu de contexto com:
| Ação | Atalho |
|---|---|
| Excluir Anotação(ões) | Delete / Backspace |
| Trazer para a Frente | Cmd/Ctrl+Shift+] |
| Enviar para Trás | Cmd/Ctrl+Shift+[ |
| Trazer para Frente | Cmd/Ctrl+] |
| Enviar para Trás | Cmd/Ctrl+[ |
Controles de Visibilidade
O menu suspenso de visibilidade (ícone de olho) permite alternar a exibição de elementos individuais:
| Alternar | Descrição |
|---|---|
| Anotações | Mostrar ou ocultar todas as sobreposições de anotação |
| Rótulos de classe | Mostrar ou ocultar rótulos de nomes de classe nas anotações |
| Mostrar pixels | Alternar renderização pixelizada para inspeção de zoom (tela cheia) |
| Retículos | Mostrar cursor em cruz com coordenadas de pixel (modo de edição) |
| Miniaturas de navegação | Mostrar tira de miniaturas de navegação (ecrã completo) |
| Mostrar tudo | Alternar anotações, rótulos, miras e miniaturas de uma vez (não afeta o pixelado) |
Cursor em Cruz
No modo de edição, uma sobreposição de mira rastreia a posição do cursor e exibe as coordenadas dos pixels na tela. Isso ajuda a posicionar anotações com precisão. Alterne-o através do menu suspenso de visibilidade.
Pré-visualização ao Passar o Mouse do SAM
No modo Smart para tarefas de segment, SAM fornece uma pré-visualização da máscara em tempo real ao passar o mouse sobre a imagem — antes de clicar em qualquer ponto. Isso permite que você veja o limite de segmentação previsto e decida onde clicar. Depois de adicionar pontos positivos ou negativos, a pré-visualização é atualizada para refletir seus refinamentos.
Edição de Vértices de Polígono
Para anotações de segment, pode editar os vértices do polígono após o desenho:
- Mover vértices: Arraste qualquer alça de vértice para reposicioná-lo
- Excluir vértices: Selecione um vértice e pressione
Deletepara removê-lo
Gestão da turma
Criação de Classes
Defina as classes de anotação para o seu conjunto de dados em Classes separador:
- Navegar para o/a
Classesguia - Utilize o campo de entrada na parte inferior para digitar um nome de classe
- Clique
Addou pressioneEnter - Uma cor é atribuída automaticamente da paleta Ultralytics

Adicionar nova classe durante a anotação
Você pode criar novas classes diretamente enquanto faz anotações, sem sair do editor:
- Desenhe uma anotação na imagem
- No menu suspenso da classe, clique em
Add New Class - Insira o nome da classe
- Pressione Enter para criar e atribuir
Isso permite um fluxo de trabalho contínuo, no qual é possível definir classes à medida que novos tipos de objetos são encontrados nos dados.
Tabela de classes unificadas
Todas as classes do seu conjunto de dados são geridas numa tabela unificada. As alterações nos nomes ou cores das classes são aplicadas automaticamente em todo o conjunto de dados.
Edição de Classes
- Renomear: Clique em um nome de classe na tabela para editá-lo diretamente
- Alterar cor: Clique na amostra de cor para abrir o seletor de cores
- Pesquisar: Use o campo de pesquisa para filtrar classes por nome
- Ordenar: Clique nos cabeçalhos das colunas para ordenar por nome, contagem de rótulos ou contagem de imagens
Cores da turma
Cada classe recebe uma cor da paleta Ultralytics. Você pode personalizar as cores usando o seletor de cores no Classes separador. As cores são consistentes em toda a plataforma para fácil reconhecimento.
Atalhos de Teclado
Anotação eficiente com atalhos de teclado:
| Atalho | Ação |
|---|---|
Cmd/Ctrl+S | Salvar anotações |
Cmd/Ctrl+Z | Desfazer |
Cmd/Ctrl+Shift+Z | Refazer |
Cmd/Ctrl+Y | Refazer (alternativa) |
Escape | Salvar / Desselecionar / Sair |
Delete / Backspace | Excluir anotação selecionada |
1-9 | Selecionar classe 1-9 |
Cmd/Ctrl+Scroll | Ampliar/reduzir |
Shift+Click | Anotações de seleção múltipla |
Cmd/Ctrl+A | Selecionar todas as anotações |
| Atalho | Ação |
|---|---|
V | Modo de desenho (manual) |
S | Modo inteligente (SAM) |
| Atalho | Ação |
|---|---|
Click+Drag | Desenhar caixa delimitadora (detect/OBB) |
Click | Adicionar ponto de polígono (segment) / Colocar esqueleto (pose) |
Right-click | Completar polígono / Adicionar ponto negativo SAM |
Shift + click/right-click | Posicione múltiplos pontos SAM antes de aplicar (aplicação automática ativada) |
A | Alternar aplicação automática (Modo inteligente) |
Enter | Completar polígono / Confirmar pose / Salvar anotação SAM |
Escape | Cancelar pose / Salvar anotação SAM / Desselecionar / Sair |
| Atalho | Ação |
|---|---|
Cmd/Ctrl+] | Trazer para frente |
Cmd/Ctrl+[ | Enviar para trás |
Cmd/Ctrl+Shift+] | Trazer para a frente |
Cmd/Ctrl+Shift+[ | Enviar para trás |

Ver Todos os Atalhos
Clique no ícone de teclado na barra de ferramentas de anotação para abrir a referência de atalhos.
Desfazer/Refazer
O editor de anotações mantém um histórico completo de desfazer/refazer:
- Desfazer:
Cmd/Ctrl+Z - Refazer:
Cmd/Ctrl+Shift+ZouCmd/Ctrl+Y
Rastreamentos do histórico:
- Adicionando anotações (individual e em lote)
- Edição de anotações (mover, redimensionar, girar)
- Excluindo anotações (individual e em lote)
- Alterar classes (individual e em lote)
- Reordenando anotações (ordem z)
- Edição de vértices de polígono (adicionar, remover, mover)
- Mover pontos-chave
Desfazer Ilimitado
A pilha de desfazer não tem limite fixo — pode desfazer todas as alterações feitas durante a sessão de edição atual, voltando ao estado original da imagem quando clicou Edit.
Salvando Anotações
As anotações são salvas ao clicar Save ou pressione Cmd/Ctrl+S:
- Salvar: Clique no botão salvar ou pressione
Cmd/Ctrl+S - Cancelar: Clique em cancelar para descartar as alterações
- Escape: Salva se houver alterações não salvas; caso contrário, sai do modo de edição
Salvar Seu Trabalho
Sempre salve antes de navegar para outra imagem. As alterações não salvas serão perdidas.
FAQ
Qual a precisão da anotação SAM?
O SAM fornece máscaras de alta qualidade para a maioria dos objetos. A precisão depende de:
- Distinção do objeto em relação ao fundo
- Qualidade e resolução da imagem
- Número de pontos positivos/negativos fornecidos
Para melhores resultados, comece com um ponto positivo no centro do objeto e adicione pontos negativos para excluir objetos próximos.
Posso importar anotações existentes?
Sim, carregue o seu conjunto de dados com ficheiros de rótulos no formato YOLO. A Plataforma analisa e exibe-os automaticamente no editor.
Como anoto múltiplos objetos da mesma classe?
Após desenhar uma anotação:
- Mantenha a mesma classe selecionada
- Desenhe a próxima anotação
- Repita até que todos os objetos estejam rotulados
O atalho de teclado 1-9 seleciona classes rapidamente.
Posso treinar com conjuntos de dados parcialmente anotados?
Sim, mas para melhores resultados:
- Rotule todos os objetos das suas classes-alvo em cada imagem
- Utilize o filtro de rótulo definido como
Unannotatedpara identificar imagens não rotuladas - Excluir imagens não anotadas da configuração de treinamento
Qual modelo SAM devo usar?
Comece com SAM 2.1 Small (o padrão) — é rápido e preciso para a maioria dos objetos. Mude para SAM 2.1 Large quando precisar de maior precisão de máscara em formas complexas. Use SAM 2.1 Tiny para velocidade máxima em objetos simples e de alto contraste. SAM 3 é o modelo de última geração e pode produzir melhores resultados em imagens desafiadoras, mas é significativamente mais lento.
Quais tarefas suportam a anotação inteligente SAM?
A anotação inteligente SAM está disponível para tarefas de detect, segment e OBB. As tarefas de classificação e pose utilizam apenas anotação manual.
Posso criar modelos de esqueleto personalizados para anotação de pose?
Sim. Clique no botão + ao lado do seletor de modelo de esqueleto para abrir o editor de modelos. Posicione os pontos-chave, nomeie-os, desenhe as conexões e salve. Modelos personalizados são armazenados em sua conta e estão disponíveis em todos os conjuntos de dados de pose.
Como alterno entre modelos de esqueleto?
Clique no menu suspenso de seleção de modelo na barra de ferramentas de anotação. Selecione qualquer modelo integrado (Pessoa, Mão, Rosto, Cão, Caixa) ou seus modelos personalizados salvos. O modelo selecionado determina quais pontos-chave são colocados ao clicar na imagem.