O recurso de detecção facial da API Video Intelligence procura rostos em um vídeo.
Detecção facial de um arquivo no Cloud Storage
As amostras a seguir demonstram a detecção facial em um arquivo localizado no Cloud Storage.
REST e LINHA DE CMD
Enviar solicitação de anotação de vídeo
Veja a seguir como enviar uma solicitação POST para o método videos:annotate
. O exemplo utiliza o token de acesso para uma conta de serviço configurada para o projeto com o SDK do Cloud. Consulte o Guia de início rápido da API Video Intelligence para instruções de como instalar o SDK do Cloud, configurar um projeto com uma conta de serviço e conseguir um token de acesso.
Fazer download dos resultados da anotação
Copiar a anotação da origem para o bucket de destino (consulte Copiar arquivos e objetos)
gsutil cp gcs_uri gs://my-bucket
Observação: se o URI gcs de saída for fornecido pelo usuário, a anotação será armazenada nesse URI do gcs.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- input-uri: um bucket do Cloud Storage que contém o arquivo que você quer anotar, incluindo o nome do arquivo. Precisa começar com gs://.
Por exemplo: `"inputUri": "gs://cloud-samples-data/video/googlework_short.mp4"`
Método HTTP e URL:
POST https://videointelligence.googleapis.com/v1p3beta1/videos:annotate
Corpo JSON da solicitação:
{ "inputUri": "input-uri", "features": ["FACE_DETECTION"] }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Se a resposta for bem-sucedida, a API Video Intelligence retornará o name
para sua operação. O exemplo acima mostra um exemplo dessa resposta, em que:
- project-number: o número do seu projeto
- location-id: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se nenhuma região for especificada, uma região será selecionada com base no local do arquivo de vídeo. - operation-id: o ID da operação de longa duração criada para a solicitação e fornecida na resposta quando você iniciou a operação. Por exemplo,
12345...
Ver os resultados de anotação
Para recuperar o resultado da operação, faça uma solicitação GET usando o nome da operação retornado da chamada para videos:annotate, conforme mostrado no exemplo a seguir.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- operation-name: o nome da operação, conforme retornado pela API Video Intelligence. O nome da operação tem o formato
projects/project-number/locations/location-id/operations/operation-id
.
Método HTTP e URL:
GET https://videointelligence.googleapis.com/v1/operation-name
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
As anotações da detecção de imagem são retornadas como uma lista shotAnnotations
.
Observação: o campo done só é retornado quando o valor dele é True.
Ele não é incluído nas respostas de uma operação não concluída.
Java
Node.js
Python
Detecção facial de um arquivo local
O exemplo a seguir usa a detecção facial para encontrar entidades em um vídeo a partir de um arquivo de vídeo enviado da máquina local.
REST e LINHA DE CMD
Enviar a solicitação de processo
Para realizar a detecção facial em um arquivo de vídeo local, codifique em base64 o conteúdo do arquivo de vídeo. Para informações sobre como codificar o conteúdo de um arquivo de vídeo em base64, consulte Codificação em Base64. Em seguida, faça uma solicitação POST para o método videos:annotate
. Inclua o conteúdo codificado em base64 no campo inputContent
da solicitação e especifique o recurso FACE_DETECTION
.
Veja abaixo um exemplo de uma solicitação POST usando curl. Esse exemplo utiliza o token de acesso para uma conta de serviço configurada para o projeto com o SDK do Cloud. Consulte o Guia de início rápido da API Video Intelligence para instruções de como instalar o SDK do Cloud, configurar um projeto com uma conta de serviço e conseguir um token de acesso
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- inputContent: Arquivo de vídeo local no formato binário
Por examplo: 'AAAAGGZ0eXBtcDQyAAAAAGlzb21tcDQyAAGVYW1vb3YAAABsbXZoZAAAAADWvhlR1r4ZUQABX5ABCOxo AAEAAAEAAAAAAA4...'
Método HTTP e URL:
POST https://videointelligence.googleapis.com/v1p3beta1/videos:annotate
Corpo JSON da solicitação:
{ inputContent: "Local video file in binary format", "features": ["FACE_DETECTION"] }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Se a solicitação for bem-sucedida, a Video Intelligence retornará o name
para sua operação. O exemplo acima mostra um exemplo dessa resposta, em que project-number
é o número do projeto e operation-id
é o ID da operação de longa duração criado para a solicitação.
{
"name": "us-west1.17122464255125931980"
}
Ver os resultados
Para recuperar o resultado da operação, faça uma solicitação GET para o endpoint operations
e especifique o nome da operação.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- operation-name: o nome da operação, conforme retornado pela API Video Intelligence. O nome da operação tem o formato
projects/project-number/locations/location-id/operations/operation-id
.
Método HTTP e URL:
GET https://videointelligence.googleapis.com/v1/operation-name
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Java
Node.js
Python