Reconhecimento de celebridades

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

Use a API Vision para detectar atributos em um arquivo de imagem local.

Para solicitações REST, envie o conteúdo do arquivo de imagem como uma string codificada em base64 no corpo da sua solicitação.

Para solicitações gcloud e da biblioteca de cliente, especifique o caminho para uma imagem local na 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 (tipo enumerado FACE_DETECTION). Os resultados incluirão informações de celebridades se uma celebridade for detectada.

REST

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.
  • PROJECT_ID pelo ID do projeto no Google Cloud.

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 com o nome request.json e execute o comando a seguir:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-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 com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

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

É possível usar a API Vision para realizar a detecção de recursos em um arquivo de imagem remoto localizado no Cloud Storage ou na Web. Para enviar uma solicitação de arquivo remoto, especifique o URL da Web do arquivo ou o URI do Cloud Storage 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 (tipo enumerado FACE_DETECTION). Os resultados incluirão informações de celebridades se uma celebridade for detectada.

REST

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

  • 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://my-cloud-bucket/img/celebrity_image.jpg
  • PROJECT_ID pelo ID do projeto do Google Cloud.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "requests": [
    {
      "image": {
        "source": {
          "imageUri": "CLOUD_STORAGE_FILE_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 com o nome request.json e execute o comando a seguir:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-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 com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

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.