Editor de anotações#

A Ultralytics Platform inclui um editor de anotações para etiquetar imagens com caixas delimitadoras, polígonos, pontos-chave, caixas orientadas e classificações. O editor suporta desenho manual, anotação inteligente com SAM e previsões de modelos YOLO compatíveis ou, em conjuntos de dados de deteção com 1–200 classes, de modelos orientados por indicações de classe: modelos de código aberto alojados ou modelos de fornecedores pagos.

Tipos de tarefa suportados#

O editor de anotações disponibiliza ferramentas de anotação para 6 tipos de tarefa YOLO:

Anotações multitarefa

Os 6 tipos de anotação são armazenados em conjunto em cada imagem. Podes alterar o tipo de tarefa ativo do conjunto de dados sem perder as anotações existentes — estas são preservadas e voltam a aparecer quando regressas a esse tipo.

A verdade de referência de profundidade é um mapa associado que carregas, não algo que desenhas; por isso, o editor abre em modo só de leitura num conjunto de dados de profundidade.

Detalhes das tarefas#

Detecção de objetos

O que faz: Identifica objetos e as respetivas localizações com caixas delimitadoras alinhadas com os eixos.

Formato da etiqueta: class_id center_x center_y width height (tudo normalizado 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, monitorização do trânsito, deteção de vida selvagem, sistemas de segurança

Segmentação de instâncias

O que faz: Cria máscaras com precisão ao nível do píxel para cada instância de objeto.

Formato da etiqueta: class_id x1 y1 x2 y2 x3 y3 ... (vértices do polígono, normalizados de 0 a 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: Imagiologia médica, veículos autónomos, edição de fotografias, análise agrícola

Estimativa de pose

O que faz: Deteta pontos-chave do corpo para acompanhar esqueletos.

Formato da etiqueta: class_id cx cy w h kx1 ky1 v1 kx2 ky2 v2 ...

• Indicadores de visibilidade: 0=não etiquetado, 1=etiquetado, mas ocluído, 2=etiquetado 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 fabrico, deteção de navios

Classificação de imagens

O que faz: Atribui uma única etiqueta à imagem inteira.

Formato da etiqueta: Baseado em pastas — imagens organizadas pelo nome da classe (train/cats/, train/dogs/)

Casos de uso: Moderação de conteúdo, controlo de qualidade, diagnóstico médico, reconhecimento de cenas

Primeiros passos#

Para anotar imagens:

1. Acede ao teu conjunto de dados
2. Clica uma vez numa imagem para abrir o editor de anotações em ecrã inteiro
3. Usa o modo predefinido Draw ou muda para Smart quando suportado
4. Seleciona uma classe e adiciona ou ajusta anotações diretamente na imagem
5. Continua para outra imagem ou fecha o editor; as alterações são salvas automaticamente após cada edição

Para conjuntos de dados que podes editar, os controlos de anotação ficam ativos assim que o visualizador em ecrã inteiro é aberto no computador. Não existe um modo de edição separado nem um botão Edit. No telemóvel, ou quando não tens acesso de edição, o visualizador em ecrã inteiro é só de leitura.

Modos de Anotação#

Draw é o modo predefinido para tarefas de anotação espacial. Para conjuntos de dados de deteção, segmentação, semântica, pose e OBB, a barra de ferramentas também disponibiliza o modo Smart quando a anotação inteligente está disponível:

A anotação de pose usa Draw com um modelo de esqueleto; o modo Smart disponibiliza apenas modelos YOLO de pose, sem seletor de SAM nem opção de aplicação automática. A classificação usa diretamente a barra lateral de classes e não apresenta qualquer barra de ferramentas de desenho nem o botão Smart.

A anotação inteligente não está atualmente disponível para conjuntos de dados ligados com armazenamento na nuvem ou On Premise, nem para conjuntos de dados com mais de três canais de imagem.

O editor memoriza o teu modo, modelo e opção de aplicação automática para cada conjunto de dados no teu navegador.

Ferramentas do Modo Desenhar#

Caixa delimitadora (deteção)#

Desenha caixas retangulares à volta dos objetos:

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, clica e arrasta para desenhar um retângulo
3. Solta o botão para concluir a caixa

Redimensionar e mover

• Arrasta as 8 alças dos cantos/bordas para redimensionar
• Arrasta o centro para mover
• Prime Delete ou Backspace para remover a anotação selecionada

Polígono (segmentação)#

Desenha máscaras poligonais precisas:

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, clica para adicionar vértices ou mantém premido Shift e move o rato para desenhar à mão livre com pontos densos
3. Faz duplo clique, clica no primeiro vértice ou prime Enter ou Escape para fechar o polígono

Durante o desenho, prime Z para remover o último vértice ou Delete para descartar o polígono.

Editar vértices

• Arrasta vértices individuais para os ajustar
• Arrasta o polígono inteiro para o mover
• Clica ou arrasta uma borda do polígono selecionado para inserir um vértice
• Clica com o botão direito num vértice e escolhe Remover ponto (os polígonos têm de manter pelo menos 3 vértices), ou clica com o botão direito numa borda e escolhe Adicionar ponto

Ponto-chave (pose)#

Anota poses com modelos de esqueleto. Seleciona um modelo na barra de ferramentas, clica uma vez para posicionar todos os pontos-chave e, em seguida, arrasta pontos-chave individuais para ajustar as posições.

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, escolhe um modelo de esqueleto no seletor de modelos da barra de ferramentas
3. Clica na imagem para posicionar todos os pontos-chave de uma só vez
4. Arrasta pontos-chave individuais para ajustar as respetivas posições

Modelos de esqueleto integrados#

O editor inclui 5 modelos integrados:

Modelos de esqueleto personalizados#

Cria modelos personalizados para qualquer estrutura de pose:

1. Abre o seletor de modelos na barra de ferramentas e escolhe Novo modelo...
2. Opcionalmente, clica em Começar a partir de... para carregar pontos-chave e ligações de um modelo existente e usá-lo como ponto de partida
3. Coloca pontos-chave na tela clicando
4. Atribui um nome a cada ponto-chave e personaliza as cores
5. Liga pontos-chave selecionando dois pontos (as ligações são desenhadas automaticamente à medida que posicionas pontos-chave em sequência)
6. Guarda o modelo para reutilizá-lo em todo o conjunto de dados

Os modelos personalizados são guardados no espaço de trabalho do conjunto de dados e ficam disponíveis em todos os respetivos conjuntos de dados de pose. Edita-os ou elimina-os no seletor de modelos.

Fluxo de trabalho dos modelos

O sistema de modelos substitui o posicionamento manual e sequencial de pontos-chave. Em vez de clicar 17 vezes para criar um esqueleto COCO, seleciona o modelo Pessoa e clica uma vez — todos os pontos-chave são posicionados no esquema correto do esqueleto. Depois, arrasta-os para ajustar as posições à pose específica.

Visibilidade dos pontos-chave

Cada ponto-chave tem um indicador de visibilidade: 0 = não anotado, 1 = anotado, mas ocluído, 2 = anotado e visível. Os pontos-chave que posicionas são anotados como visíveis (2). Clica com o botão direito num ponto-chave e escolhe Ocultar ponto para marcá-lo como não anotado (0), ou clica com o botão direito na pose e escolhe Repor visibilidade para voltar a mostrar os pontos-chave ocultos. As etiquetas importadas mantêm os respetivos indicadores de visibilidade.

Caixa delimitadora orientada (OBB)#

Desenha caixas rodadas para objetos inclinados:

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, clica e arrasta para desenhar uma caixa inicial
3. Usa a alça de rotação para ajustar o ângulo
4. Arrasta as alças dos cantos para redimensionar

Classificação (classificar)#

Atribui etiquetas de classe ao nível da imagem:

1. Clica numa imagem para abrir o editor em ecrã inteiro
2. Seleciona uma classe na barra lateral de classes ou prime uma tecla numérica de 1-9

Anotação inteligente#

A anotação inteligente adiciona ao editor a anotação assistida por modelos. No modo Inteligente, podes usar o Segment Anything Model (SAM) para anotar clicando, ou usar modelos YOLO pré-treinados da Ultralytics e os teus próprios modelos YOLO ajustados para adicionar previsões como anotações. Em conjuntos de dados de deteção com 1–200 classes, o seletor também disponibiliza modelos orientados por classes que detetam as classes do conjunto de dados: seis modelos alojados de código aberto, SAM 3 e SAM 3.1 alojados e orientados por texto, e modelos de visão pagos de nove fornecedores. A anotação inteligente com SAM está disponível para as tarefas detect, segment, semantic e OBB; a anotação inteligente com YOLO também abrange pose.

Anotação inteligente com SAM#

Com um modelo SAM selecionado:

1. Seleciona Smart ou prime S
2. Clica no objeto que queres anotar — o SAM gera uma máscara inicial em tempo real
3. Refina a máscara com cliques adicionais: clica fora da máscara atual para aumentar a área abrangida ou clica dentro da máscara atual para subtrair regiões
4. Prime Enter ou Escape para guardar a anotação, ou ativa a aplicação automática para fluxos de trabalho com um só clique

Sugestões para SAM

• Começa por clicar no centro do objeto
• Clica novamente fora da máscara para aumentar a área abrangida
• Clica dentro da máscara para subtrair regiões indesejadas
• Ativa a aplicação automática (A) para anotar com um só clique
• Mantém premido Shift enquanto a aplicação automática está ativada para posicionar vários pontos antes de aplicar a máscara
• Funciona melhor com objetos distintos e contornos nítidos
• Usa alguns cliques de refinamento para objetos alongados ou sobrepostos

A anotação inteligente com SAM pode gerar:

• Polígonos para tarefas de segmentação
• Caixas delimitadoras para tarefas de deteção
• Caixas orientadas para tarefas OBB

Suporte do SAM por tarefa

A anotação inteligente com SAM está disponível apenas para as tarefas detect, segment, semantic e OBB. Conjuntos de dados de pose usam a anotação inteligente YOLO, enquanto a classificação requer anotação manual.

Modo de aplicação automática#

O modo de aplicação automática acelera a anotação inteligente ao salvar automaticamente a máscara SAM após cada clique — não é preciso pressionar Enter. Ative ou desative o modo com o botão de aplicação automática na barra de ferramentas ou pressione A.

Quando usar a aplicação automática

A aplicação automática é ideal para conjuntos de dados com objetos bem separados, nos quais um único clique produz uma máscara precisa. Para objetos complexos ou sobrepostos, desative a aplicação automática e use vários pontos positivos/negativos para refinar a máscara antes de salvar.

Seleção do modelo SAM#

Quando o modo inteligente está ativo, um seletor de modelos aparece na barra de ferramentas. Há seis modelos SAM disponíveis — escolha com base no equilíbrio entre velocidade e precisão mais adequado ao seu conjunto de dados:

Ao trocar de modelo com o modo inteligente ativo, o preditor é reinicializado automaticamente para a imagem atual.

Anotação inteligente YOLO#

Com um modelo YOLO selecionado, a anotação inteligente pode adicionar previsões de modelos Ultralytics pré-treinados ou dos seus próprios modelos ajustados.

1. Seleciona Smart ou prime S
2. Selecione um modelo YOLO no seletor de modelos da barra de ferramentas (Models ou My Models)
3. Clique em Predict
4. Revise as anotações adicionadas e faça as correções necessárias

Observações sobre modelos YOLO

• O seletor de modelos lista os modelos compatíveis com a tarefa do conjunto de dados atual; por isso, um conjunto de dados de pose oferece modelos de pose. Os conjuntos de dados de detecção e segmentação também exibem os modelos uns dos outros, desativados.
• Se as classes do modelo forem diferentes das classes do conjunto de dados, uma caixa de diálogo Mapear classes associa cada classe do modelo a uma classe do conjunto de dados ou a ignora; se o conjunto de dados não tiver classes, a caixa de diálogo as cria.
• Previsões duplicadas são ignoradas quando se sobrepõem a uma anotação existente da mesma classe com IoU 0.7 ou superior.

Anotação inteligente com prompts de classe#

Em um conjunto de dados de detecção com 1–200 classes, o projeto Modelos de código aberto do seletor de modelos lista seis modelos hospedados — Moondream 3.1 (o padrão ao abrir o modo inteligente em um conjunto de dados de detecção), Qwen3.8 27B, YOLOE-26x, Florence-2 Large, OWLv2 Large e Grounding DINO Base. O projeto Meta adiciona SAM 3 Text e SAM 3.1 Text, hospedados e acionados por prompts de texto, que detectam as classes do conjunto de dados na imagem inteira, além do modelo pago muse-spark-1.3 da Meta. Os projetos OpenAI, Anthropic, Google, SpaceXAI, DeepSeek, Z.ai, Kimi e Xiaomi MiMo listam os modelos de visão pagos de cada provedor. Selecione um modelo e clique em Predict (ou pressione P): o modelo detecta as classes do conjunto de dados com limites específicos para o modelo e adiciona caixas editáveis, que você pode revisar e salvar como as previsões YOLO. Esses modelos não retornam pontuações de confiança; portanto, as configurações de previsão (confiança e IoU) ficam ocultas enquanto um deles está selecionado.

Um modelo pago de um provedor é executado com a chave do provedor salva em Configurações > Chaves de API do espaço de trabalho do conjunto de dados; sem uma chave, a previsão falha e oferece a opção Adicionar chave de API. O provedor cobra da sua chave por cada previsão. Após cada previsão, uma notificação mostra o número de objetos detectados, o tempo decorrido e o custo: Grátis para um modelo hospedado; para um modelo pago, o custo estimado pelo provedor, quando disponível, ou então Cobrado por e o nome do provedor.

Anotação em lote#

A anotação em lote executa um modelo — um modelo YOLO ou, em conjuntos de dados de detecção com 1–200 classes, um modelo com prompts de classe — em todo o conjunto de dados, em vez de apenas na imagem aberta. Abra o recurso na página do conjunto de dados em Mais ações > Anotação em lote ou pela ação Anotar tudo na notificação após uma previsão no editor que encontre objetos. Está disponível para editores de conjuntos de dados hospedados na Platform com até três canais de imagem, para todas as tarefas, exceto profundidade.

1. Selecione um modelo no seletor (Models, incluindo Modelos de código aberto e projetos de provedores em conjuntos de dados de detecção com 1–200 classes, ou My Models); em um conjunto de dados de detecção, a caixa de diálogo abre com Moondream 3.1 selecionado
2. Para um modelo YOLO, ajuste os controles deslizantes de confiança (padrão 0.25) e IoU (padrão 0.7) — as imagens de amostra ao lado das configurações mostram o que o modelo encontra conforme você move os controles. Um modelo com prompts de classe detecta as classes do conjunto de dados (1–200) usando limites específicos para o modelo, em vez dessas configurações, e não retorna pontuações
3. Ative Incluir imagens anotadas para também executar o modelo em imagens que já têm rótulos; a execução adiciona o que o modelo encontra e mantém os rótulos existentes
4. Revise o Custo estimado e clique em Iniciar

Por padrão, apenas imagens sem rótulos são anotadas, e os rótulos existentes nunca são alterados. A execução requer classes no conjunto de dados. Para um modelo YOLO, se as classes do modelo forem diferentes das classes do conjunto de dados, uma etapa Mapear classes associa cada classe do modelo a uma classe do conjunto de dados ou a ignora; se o conjunto de dados não tiver classes, essa etapa as cria — a execução só começa depois que as classes existem. Ao iniciar uma execução, uma versão do conjunto de dados é salva primeiro, para que você possa restaurar o conjunto de dados caso não goste do resultado.

A página do conjunto de dados mostra o andamento da execução, e Parar mantém e cobra pelas imagens processadas até então. Quando a execução termina, um resumo mostra as imagens processadas e as anotações e classes adicionadas.

Custo da anotação em lote

A anotação em lote custa US$ 1,00 por 1.000 imagens processadas, com um mínimo de US$ 0,01 por execução. O valor estimado é retido do seu saldo quando a execução começa e ajustado conforme as imagens realmente processadas; a cobrança aparece na guia Faturamento como Anotação automática quando você fecha o resumo da execução. Com um modelo pago de provedor, esse valor cobre apenas a taxa de processamento da Platform: o provedor também cobra da sua chave de API pelas prévias da execução de teste e pelas anotações.

Barra lateral de classes#

O editor de anotações inclui uma barra lateral de classes recolhível, no lado direito da tela. A barra lateral oferece:

• Pesquisar classes: Filtre a lista de classes digitando no campo de pesquisa. Pressione Enter para selecionar uma correspondência exata ou crie uma nova classe se não houver correspondência.
• Criar classe em linha: Clique em Add class na parte inferior da lista, digite um nome e, opcionalmente, escolha uma cor personalizada. Pressione Enter para criar a classe.
• Editar nome da classe em linha: Passe o cursor sobre o nome de uma classe e clique no ícone de lápis para renomeá-la.
• Seletor de cores: Clique na amostra de cor ao lado de qualquer classe para alterar a cor.
• Contagem de anotações por classe: Cada linha de classe mostra a contagem de anotações em sobrescrito.
• Expandir/recolher: Clique na seta para expandir uma classe e ver as anotações individuais listadas abaixo dela.
• Realce bidirecional ao passar o cursor: Ao passar o cursor sobre uma anotação na tela, ela é realçada na barra lateral, e vice-versa. A barra lateral rola automaticamente até a classe correspondente. Ao passar o cursor sobre uma linha de classe ou sobre o marcador dessa classe no detalhamento abaixo da imagem, todas as anotações da classe são realçadas.
• Ocultar/mostrar uma classe inteira: Clique no ícone de olho em uma linha de classe para ocultar ou mostrar todas as anotações dessa classe de uma só vez.
• 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 de lixeira em qualquer linha de anotação para excluí-la.
• Atalhos de teclado: Pressione 1-9 para selecionar rapidamente as 9 primeiras classes, H para alternar a visibilidade de todas as anotações da imagem ou ] para mostrar ou ocultar a barra lateral.

Menu de contexto#

Clique com o botão direito em uma anotação para abrir um menu de contexto com:

Clicar com o botão direito em um vértice ou aresta de polígono oferece Remover ponto ou Adicionar ponto; clicar com o botão direito em um ponto-chave de pose oferece Ocultar ponto e Redefinir visibilidade. O menu também oferece Desfocar rostos quando disponível.

Controles de visibilidade#

O menu suspenso de visibilidade (ícone de olho) permite alternar a exibição de elementos individuais:

Cursor em forma de mira#

Durante a anotação, uma sobreposição em forma de mira acompanha a posição do cursor e exibe as coordenadas de pixel na tela. Isso ajuda a posicionar as anotações com precisão. Ative ou desative esse recurso pelo menu suspenso de visibilidade.

Prévia ao passar o cursor com SAM#

No modo inteligente, o SAM fornece uma prévia em tempo real ao passar o cursor, antes de você clicar em qualquer ponto. Essa prévia está disponível para as tarefas detect, segment, semantic e OBB. Depois que você adiciona cliques de refinamento, a prévia é atualizada para refletir a máscara atual e o tipo de anotação da tarefa ativa.

Edição de vértices de polígonos#

Para anotações de segmentação e semânticas, você pode editar os vértices do polígono após desenhá-lo:

• Mover vértices: Arraste qualquer alça de vértice para reposicioná-la
• Adicionar vértices: Clique ou arraste uma aresta do polígono selecionado, ou clique com o botão direito em uma aresta e escolha Adicionar ponto
• Remover vértices: Clique com o botão direito em um vértice e escolha Remover ponto; os polígonos mantêm pelo menos 3 vértices

Gerenciamento de classes#

Criar classes#

Define as classes de anotação do teu conjunto de dados na aba Classes:

1. Acede à aba Classes
2. Usa o campo de entrada na parte inferior para escrever o nome de uma classe
3. Clica em Add ou prime Enter
4. Uma cor é atribuída automaticamente a partir da paleta da Ultralytics

Adicionar uma nova classe durante a anotação#

Podes criar novas classes diretamente durante a anotação, sem sair do editor:

1. Desenha uma anotação na imagem
2. Na barra lateral de classes, clica em Add class (ou escreve um novo nome na caixa de pesquisa da barra lateral)
3. Introduz o nome da classe
4. Prime Enter para criar e atribuir a classe

Isto permite um fluxo de trabalho contínuo, no qual podes definir classes à medida que encontras novos tipos de objetos nos teus dados.

Tabela unificada de classes

Todas as classes do teu conjunto de dados são geridas numa tabela unificada. As alterações aos nomes ou às cores das classes são aplicadas automaticamente em todo o conjunto de dados.

Editar classes#

• Renomear: clica no nome de uma classe na tabela para editá-lo diretamente
• Alterar a cor: clica na amostra de cor para abrir o seletor de cores
• Pesquisar: usa o campo de pesquisa para filtrar classes pelo nome
• Ordenar: clica nos cabeçalhos das colunas para ordenar por índice, nome, número de anotações ou número de imagens

Cores das classes#

É atribuída uma cor a cada classe a partir da paleta da Ultralytics. Podes personalizar as cores com o seletor de cores na aba Classes; as cores selecionadas são usadas em todo o conjunto de dados.

Atalhos de teclado#

Anotação eficiente com atalhos de teclado:

Ver todos os atalhos

Clica no ícone de teclado na barra de ferramentas de anotação para abrir a lista de atalhos.

Anular/refazer#

O editor de anotações mantém um histórico completo de ações para anular e refazer:

• Anular: Cmd/Ctrl+Z
• Refazer: Cmd/Ctrl+Y

O histórico regista:

• Adicionar anotações (individualmente e em lote)
• Editar anotações (mover, redimensionar, rodar)
• Eliminar anotações (individualmente e em lote)
• Alterar classes (individualmente e em lote)
• Reordenar anotações (ordem Z)
• Editar vértices de polígonos (adicionar, remover, mover)
• Mover pontos-chave

Anulação ilimitada

A pilha de anulações não tem um limite fixo — podes anular alterações feitas desde que abriste a imagem.

Guardar anotações#

As alterações são guardadas automaticamente um segundo após a última edição de uma anotação. Também são guardadas quando passas para outra imagem ou fechas o editor em ecrã inteiro.

• Guardar agora: clica no botão de guardar ou prime Cmd/Ctrl+S
• Fechar: clica no botão de fechar, clica fora da imagem ou prime Escape; ao fechar, as alterações pendentes são guardadas em segundo plano

Guarda o teu trabalho

Espera que o estado Saving... ou Unsaved desapareça da barra de informações da imagem antes de fechares o separador do navegador. Podes guardar manualmente a qualquer momento com o botão de guardar ou Cmd/Ctrl+S.

Perguntas frequentes#