Reconhecimento de celebridade

Esta página descreve como reconhecer celebridades em imagens usando a API do Vision.

A API do Vision permite detectar rostos em uma imagem. Ao reconhecer um rosto, a API do Vision pode compará-lo com uma galeria indexada de celebridades coletadas pelo Google.

A API do Vision pode reconhecer milhares de celebridades e destina-se ao uso somente em conteúdo de mídia fotografada profissionalmente, em que celebridades de fácil reconhecimento aparecem na imagem.

Se uma correspondência for encontrada, a API do Vision fornecerá o ID da máquina (MID, na sigla em inglês) do mapa de informações da celebridade, o nome dela e uma caixa delimitadora indicando onde o rosto aparece na imagem.

Solicitar acesso à API

Este recurso destina-se ao uso por empresas de mídia e entretenimento ou por parceiros aprovados que envolve conteúdo de mídia produzido profissionalmente. Para solicitar acesso à API, envie este formulário com informações sobre sua empresa e caso de uso.

Solicitar reconhecimento de celebridade para uma imagem local

A API Vision pode realizar a detecção de recursos em um arquivo de imagem local enviando o conteúdo do arquivo de imagem como uma string codificada em base64 no corpo da sua solicitação.

Para enviar uma solicitação de reconhecimento de celebridade, primeiro você recebe acesso ao recurso para seu projeto e depois usa o recurso atual de detecção facial (enum FACE_DETECTION). Os resultados incluirão informações de celebridades se uma celebridade for detectada.

REST e LINHA DE CMD

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • base64-encoded-image: a representação base64 (string ASCII) dos dados da imagem binária. Essa string precisa ser semelhante à seguinte:
    • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
    Veja mais informações no tópico Codificação base64.

Método HTTP e URL:

POST https://vision.googleapis.com/v1p4beta1/images:annotate

Corpo JSON da solicitação:

{
  "requests": [
    {
      "image": {
        "content": "base64-encoded-image"
      },
      "features": [
        {
          "type": "FACE_DETECTION"
        }
      ],
      "imageContext": {
        "faceRecognitionParams": {
            "celebritySet": ["builtin/default"]
        }
      }
    }
  ]
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://vision.googleapis.com/v1p4beta1/images:annotate

PowerShell

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Solicitar reconhecimento de celebridade para uma imagem remota

Para sua conveniência, a API Vision pode realizar a detecção de recursos diretamente em um arquivo de imagem localizado no Google Cloud Storage ou na Web sem a necessidade de enviar o conteúdo do arquivo de imagem no corpo da solicitação.

Para enviar uma solicitação de reconhecimento de celebridade, primeiro você recebe acesso ao recurso para seu projeto e depois usa o recurso atual de detecção facial (enum FACE_DETECTION). Os resultados incluirão informações de celebridades se uma celebridade for detectada.

REST e LINHA DE CMD

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

gs://my-cloud-bucket/img/celebrity_image.jpg
  • cloud-storage-image-uri: o caminho para um arquivo de imagem válido em um bucket do Cloud Storage. Você precisa ter, pelo menos, privilégios de leitura para o arquivo. Exemplo:
    • gs://storage-bucket/filename.jpg

Método HTTP e URL:

POST https://vision.googleapis.com/v1p4beta1/images:annotate

Corpo JSON da solicitação:

{
  "requests": [
    {
      "image": {
        "source": {
          "imageUri": "cloud-storage-image-uri"
        }
      },
      "features": [
        {
          "type": "FACE_DETECTION"
        }
      ],
      "imageContext": {
        "faceRecognitionParams": {
            "celebritySet": ["builtin/default"]
        }
      }
    }
  ]
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://vision.googleapis.com/v1p4beta1/images:annotate

PowerShell

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Solicitar desativação de celebridade

Se você é uma celebridade e não quer ser incluído neste recurso para a API do Cloud Vision ou do Video Intelligence, preencha e envie este formulário.

Denunciar uso indevido

Se você suspeitar que o recurso Reconhecimento de celebridades da API do Vision está sendo usado indevidamente de alguma forma, informe-nos usando este formulário.