A deteção de conteúdo explícito deteta conteúdo para adultos em vídeos. O conteúdo para adultos é geralmente impróprio para menores de 18 anos e inclui, entre outros, nudez, atividades sexuais e pornografia. Também é identificado conteúdo deste tipo detetado em desenhos animados ou anime.
A resposta inclui um valor de probabilidade
em função do intervalo, de VERY_UNLIKELY
a VERY_LIKELY
.
Quando a deteção de conteúdo explícito avalia um vídeo, fá-lo frame a frame e considera apenas o conteúdo visual. O componente de áudio do vídeo não é usado para avaliar o nível de conteúdo explícito.
Segue-se um exemplo de como realizar a análise de vídeo para as funcionalidades de deteção de conteúdo explícito num ficheiro localizado no Cloud Storage.
REST
Envie uma solicitação de anotação de vídeo
O exemplo seguinte mostra como enviar um pedido POST para o método
videos:annotate
. O exemplo usa a Google Cloud CLI para criar um token de acesso. Para ver instruções sobre a instalação da CLI gcloud, consulte o
guia de início rápido da Video Intelligence API.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- INPUT_URI: um contentor do Cloud Storage que contém o ficheiro que quer anotar, incluindo o nome do ficheiro. Tem de
começar com
gs://
.
Por exemplo:"inputUri": "gs://cloud-videointelligence-demo/assistant.mp4",
- PROJECT_NUMBER: o identificador numérico do seu Google Cloud projeto
Método HTTP e URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corpo JSON do pedido:
{ "inputUri": "INPUT_URI", "features": ["EXPLICIT_CONTENT_DETECTION"] }
Para enviar o seu pedido, expanda uma destas opções:
Deve receber uma resposta JSON semelhante à seguinte:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" }
Se a resposta for bem-sucedida, a Video Intelligence API devolve o name
para a sua operação. O exemplo acima mostra uma resposta deste tipo, em que:
- PROJECT_NUMBER: o número do seu projeto.
- LOCATION_ID: a região da nuvem onde a anotação deve ocorrer. As regiões da nuvem suportadas são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se não for especificada nenhuma região, é determinada uma região com base na localização do ficheiro de vídeo. - OPERATION_ID: o ID da operação de longa duração criada
para o pedido e fornecido na resposta quando iniciou a
operação, por exemplo,
12345...
Obtenha resultados de anotações
Para obter o resultado da operação, faça um pedido GET, usando o nome da operação devolvido da chamada para videos:annotate
, conforme mostrado no exemplo seguinte.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- OPERATION_NAME: o nome da operação, conforme
devolvido pela API Video Intelligence. O nome da operação tem o formato
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: o identificador numérico do seu Google Cloud projeto
Método HTTP e URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Para enviar o seu pedido, expanda uma destas opções:
Deve receber uma resposta JSON semelhante à seguinte:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "/demomaker/gbikes_dinosaur.mp4", "progressPercent": 100, "startTime": "2020-03-26T00:16:35.112404Z", "updateTime": "2020-03-26T00:16:55.937889Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse", "annotationResults": [ { "inputUri": "/demomaker/gbikes_dinosaur.mp4", "explicitAnnotation": { "frames": [ { "timeOffset": "0.056149s", "pornographyLikelihood": "VERY_UNLIKELY" }, { "timeOffset": "1.166841s", "pornographyLikelihood": "VERY_UNLIKELY" }, ... { "timeOffset": "41.678209s", "pornographyLikelihood": "VERY_UNLIKELY" }, { "timeOffset": "42.596413s", "pornographyLikelihood": "VERY_UNLIKELY" } ] } } ] } }
shotAnnotations
.
Nota: o campo done só é devolvido quando o respetivo valor é True.
Não está incluído nas respostas para as quais a operação não foi concluída.
Transfira os resultados das anotações
Copie a anotação da origem para o contentor de destino: (consulte o artigo Copie ficheiros e objetos)
gcloud storage cp gcs_uri gs://my-bucket
Nota: se o URI do GCS de saída for fornecido pelo utilizador, a anotação é armazenada nesse URI do GCS.
Go
Java
Para se autenticar no Video Intelligence, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Para se autenticar no Video Intelligence, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações sobre a instalação e a utilização da biblioteca cliente da Cloud Video Intelligence API para Python, consulte o artigo Bibliotecas cliente da Cloud Video Intelligence API.Idiomas adicionais
C#: Siga as instruções de configuração do C# na página das bibliotecas cliente e, em seguida, visite a documentação de referência da Video Intelligence API para .NET.
PHP: Siga as instruções de configuração do PHP na página das bibliotecas cliente e, em seguida, visite a documentação de referência da Video Intelligence API para PHP.
Ruby: Siga as instruções de configuração do Ruby na página das bibliotecas cliente e, em seguida, visite a documentação de referência da Video Intelligence API para Ruby.