Todos os produtos
Search
Central de documentação

Intelligent Media Management:Perguntas frequentes sobre gerenciamento de imagens

Última atualização: Jun 27, 2026

Este tópico responde às perguntas frequentes sobre o gerenciamento de imagens no Intelligent Media Management (IMM).

Limite de imagens por dataset

Sim. A quantidade de imagens em um dataset não pode exceder a cota de arquivos configurada. Para mais informações, consulte Cotas.

Definição da granularidade do dataset

Consultas e agrupamento facial não funcionam entre datasets diferentes. Particione seus dados considerando essa restrição. Por exemplo, em um aplicativo de álbum de fotos na nuvem, crie um dataset separado para cada usuário final.

Falha na criação de grupos pelo agrupamento facial

Para garantir a precisão do agrupamento facial, atenda aos seguintes requisitos:

  • Use a operação IndexFileMeta para adicionar imagens ao dataset.

  • O dataset deve conter pelo menos três imagens faciais de alta qualidade da mesma pessoa que atendam aos critérios abaixo:

    • Tamanho do rosto superior a 75 × 75 pixels.

    • Valor absoluto de cada um dos três elementos no parâmetro HeadPose menor que 30°.

    • Valor de FaceQuality maior que 0,8.

Após a criação de um grupo facial, outras imagens do dataset que não atendam a esses critérios de alta qualidade ainda poderão ser incluídas no mesmo grupo.

Consulta de imagens em um grupo facial

Chame a operação SimpleQuery com o ID do grupo facial no parâmetro Query para obter a lista de imagens desse grupo, conforme o exemplo a seguir.

Nota

Chame a operação QueryFigureClusters para obter o FigureClusterId (ID do grupo facial) no parâmetro FigureClusters da resposta.

{
  "Field ": "Figures.FigureClusterId ",
  "Operation ": "eq ",
  "Value ": "your-face-group-id"
}

Novos grupos faciais ausentes nos resultados de pesquisa

A indexação de metadados é um processo assíncrono. A indexação de imagens, o agrupamento facial e a disponibilidade para pesquisa levam tempo para concluir. Ao projetar a lógica do aplicativo, considere possíveis problemas de consistência de dados causados por esse atraso.

  • Indexação de imagens: a chamada à operação IndexFileMeta para indexar uma imagem leva cerca de 10 segundos.

  • Agrupamento facial: a execução da operação CreateFigureClusteringTask pode levar até 180 segundos. O tempo real varia conforme a quantidade de imagens indexadas em um único lote, mas a conclusão geralmente ocorre em poucos segundos.

    Importante

    A operação CreateFigureClusteringTask depende da operação IndexFileMeta para detectar rostos nas imagens. Se você usar o Message Service (MNS) para assinar os resultados da chamada IndexFileMeta, aguarde pelo menos 10 segundos após a conclusão dessa chamada antes de invocar CreateFigureClusteringTask. Isso garante que CreateFigureClusteringTask acesse as informações faciais mais recentes.

  • Após a conclusão de operações assíncronas como IndexFileMeta e CreateFigureClusteringTask, a operação SimpleQuery pode levar até 10 segundos para retornar os resultados atualizados.

Necessidade de chamar CreateFigureClusteringTask para cada imagem indexada?

Essa abordagem não é recomendada. A operação CreateFigureClusteringTask executa agrupamento incremental. Chame-a uma única vez para processar um lote de imagens recém-indexadas. Considere as duas estratégias abaixo:

  • Abordagem simples: para cada dataset, invoque a operação CreateFigureClusteringTask em intervalos fixos, como a cada 5 minutos.

  • Abordagem recomendada: sempre que chamar a operação IndexFileMeta, envie o dataset correspondente para uma fila com atraso. Recupere periodicamente o DatasetName dessa fila para identificar datasets com novas imagens. Execute a operação CreateFigureClusteringTask 10 segundos após a chamada mais recente de IndexFileMeta para esse dataset.

Agrupamento de várias pessoas em uma única imagem

O agrupamento facial opera no nível de cada rosto individual. Se uma imagem contiver várias pessoas, cada rosto será avaliado independentemente e poderá ser atribuído a um grupo facial distinto.

Inclusão de outros rostos nos resultados do SimpleQuery

A operação SimpleQuery retorna resultados no nível da imagem, incluindo todos os rostos e tags encontrados nela. Para localizar as informações específicas do rosto da pessoa pesquisada, itere pelo campo Figures na resposta. Busque o objeto de rosto cujo FigureClusterId corresponda ao ID usado na consulta. Esse objeto contém detalhes como posição do rosto, expressão e idade.

Obtenção de resultados de CreateFacesSearchingTask sem notificações

A operação CreateFacesSearchingTask entrega resultados exclusivamente por meio de notificações. A operação GetTask permite consultar o status da tarefa, mas não recupera os resultados da pesquisa.

Modifique história existente ao chamar CreateStory novamente?

Ao executar a operação CreateStory sem informar o parâmetro ObjectId, o sistema cria uma nova história. Se você fornecer um ObjectId, a história existente com esse ID será atualizada.

Suporte a processamento de IA na junção de imagens?

Não. Esse recurso não oferece suporte a processamento de IA. Ele realiza apenas uma mesclagem simples das imagens, sem análise de conteúdo.