Nesta página, explicamos como reconhecer celebridades em imagens usando a API 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 Vision pode reconhecer milhares de celebridades e destina-se ao uso somente em fotografias profissionais em que celebridades de fácil reconhecimento aparecem.
Se alguma celebridade for encontrada, a API Vision vai mostrar 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 é voltado para uso em mídia profissional por empresas de mídia e entretenimento ou parceiros aprovados. Para solicitar acesso à API, envie este formulário com informações sobre sua empresa e caso de uso.
Solicitar o reconhecimento de celebridade em 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 solicitação.
Para solicitações gcloud e da biblioteca de cliente, especifique o caminho para uma imagem local na 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).
Se uma celebridade for detectada, o resultado vai conter informações sobre ela.
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. A string precisa ser semelhante à seguinte:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: o 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": {
"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ê vai receber uma resposta JSON semelhante a esta:
Solicitar o reconhecimento de celebridade em uma imagem remota
Use a API Vision para realizar a detecção de recursos em um arquivo de imagem 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).
Se uma celebridade for detectada, o resultado vai conter informações sobre ela.
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: o 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ê vai receber uma resposta JSON semelhante a esta:
Solicitar exclusão de celebridade
Se você é uma celebridade e não quer participar deste recurso da API Cloud Vision ou Video Intelligence, preencha e envie este formulário.
Denunciar uso indevido
Se você suspeitar que o recurso de reconhecimento de celebridades da API Vision está sendo usado indevidamente de alguma forma, informe-nos usando este formulário.