As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Entender as operações de imagem e vídeo do Rekognition O Amazon Rekognition oferece dois conjuntos principais de APIs para análise de imagens e vídeos: + Amazon Rekognition Image: essa API foi projetada para analisar imagens. + Amazon Rekognition Video: essa API se concentra na análise de vídeos armazenados e em streaming. Ambos APIs podem detectar várias entidades, como rostos e objetos. Para uma compreensão abrangente dos tipos de comparação e detecção com suporte, consulte a seção sobre [Entender os tipos de análise do Rekognition](how-it-works-types.md). ## Operações do Amazon Rekognition Image As operações do Amazon Rekognition Image são síncronas. A entrada e a resposta estão em formato JSON. As operações do Amazon Rekognition Image analisam uma imagem de entrada que está no formato de imagem.jpg ou.png. A imagem passada para uma operação do Amazon Rekognition Image pode ser armazenada em um bucket do Amazon S3. Se você não estiver usando a AWS CLI, você também pode passar bytes de imagens codificadas em Base64 diretamente para uma operação do Amazon Rekognition. Para obter mais informações, consulte [Trabalhar com imagens](https://docs.aws.amazon.com/rekognition/latest/dg/images.html). ## Operações de vídeo do Amazon Rekognition Video A API do Amazon Rekognition Video facilita a análise de vídeos armazenados em um bucket do Amazon S3 ou transmitidos por meio do Amazon Kinesis Video Streams. Para operações de vídeo armazenadas, observe o seguinte: + As operações são assíncronas. + A análise deve ser iniciada com uma operação “Iniciar” (por exemplo, [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html)para detecção facial em vídeos armazenados). + O status de conclusão da análise é publicado em um tópico do Amazon SNS. + Para recuperar os resultados de uma análise, use a operação “Obter” correspondente (por exemplo, [GetFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetFaceDetection.html)). + Para ter mais informações, consulte [Trabalhar com operações de análise de vídeo](https://docs.aws.amazon.com/rekognition/latest/dg/video.html). Para análise de streaming de vídeo: + Os recursos incluem pesquisa facial nas coleções de vídeos do Rekognition e detecção de rótulos (objetos ou conceitos). + Os resultados da análise de rótulos são enviados como notificações do Amazon SNS e do Amazon S3. + Os resultados de pesquisa facial são enviados a um fluxo de dados do Kinesis. + O gerenciamento da análise de streaming de vídeo é feito por meio de um processador de streaming de vídeo Amazon Rekognition Video (por exemplo, crie um processador usando). [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html) + Para ter mais informações consulte [Trabalhar com eventos de vídeo em streaming](https://docs.aws.amazon.com/rekognition/latest/dg/streaming-video.html). Cada operação de análise de vídeo retorna metadados sobre o vídeo que está sendo analisado, bem como um ID de trabalho e uma tag de trabalho. Operações como Detecção de rótulo e Moderação de conteúdo para vídeo permitem classificar por carimbo de data/hora ou nome do rótulo e agregar os resultados por carimbo de data/hora ou segmento. ## Operações não baseadas em armazenamento e baseadas em armazenamento As operações do Amazon Rekognition estão agrupadas nas seguintes categorias. + **Operações de API que não são de armazenamento** — Nessas operações, o Amazon Rekognition não mantém nenhuma informação. Você fornece imagens e vídeos de entrada, a operação realiza a análise e retorna os resultados, mas nada é salvo pelo Amazon Rekognition. Para obter mais informações, consulte [Operações que não são de armazenamento](how-it-works-storage-non-storage.md#how-it-works-non-storage). + **Operações de API baseadas em armazenamento** — Os servidores Amazon Rekognition podem armazenar informações faciais detectadas em contêineres conhecidos como coleções. O Amazon Rekognition fornece operações adicionais de API que você pode usar para pesquisar as informações persistentes da face em busca de correspondências faciais. Para obter mais informações, consulte [Operações de API baseadas em armazenamento](how-it-works-storage-non-storage.md#how-it-works-storage-based). ## Usando o AWS SDK ou HTTP para chamar as operações da API Amazon Rekognition Você pode chamar as operações da API Amazon Rekognition usando o AWS SDK ou diretamente usando HTTP. Você deve usar sempre o AWS SDK, a menos que tenha um bom motivo para não fazer isso. Os exemplos de Java nesta seção usam o [AWS SDK](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-install.html). Embora um arquivo de projeto Java não seja fornecido, é possível usar o [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/AWSToolkitEclipse/latest/GettingStartedGuide/) para desenvolver aplicativos da AWS usando Java. Os exemplos do .NET nesta seção usam o [AWS SDK para .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/welcome.html). É possível usar o [AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/welcome.html) para desenvolver aplicativos da AWS que usam o .NET. Ele inclui modelos úteis e o AWS Explorer para implantar aplicativos e gerenciar serviços. A [referência de API](https://docs.aws.amazon.com/rekognition/latest/APIReference/Welcome.html) neste guia aborda a chamada de operações do Amazon Rekognition usando HTTP. Para obter informações de referência sobre Java, consulte [AWS SDK para Java](https://docs.aws.amazon.com/sdk-for-java/latest/reference/index.html). Os endpoints do serviço Amazon Rekognition que você pode usar estão documentados nas [Regiões e endpoints da AWS.](https://docs.aws.amazon.com/general/latest/gr/rande.html#rekognition_region) Ao chamar o Amazon Rekognition com HTTP, use as operações HTTP POST.